教程

解决fuwari博客使用umami统计访问量时重复统计问题

在写博客添加访问量统计那篇文章时,就发现了进入文章后访问量会计算双数,进一次统计增加两次,当时一直不知道原因就将就用了。

后面看到https://2x.nz/posts/swup-js/这篇文章时才把这个问题解决。

具体原因是在 Fuwari 博客主题中使用 Umami 统计访问量时出现重复计算,根本原因在于 单页应用(SPA)路由切换机制与 Umami 统计脚本的交互冲突 。

Fuwari 使用了 swup 来实现页面间的平滑过渡效果。swup 是一个前端路由库,它通过 AJAX 加载新页面内容并替换 DOM,而不是传统的整页刷新。

然而,Umami 的统计脚本默认设计是针对传统多页应用的——每次页面加载时执行一次。当 swup 接管导航后,页面并不会真正刷新,但 Umami 脚本却可能被多次触发:

  • 首次进入页面:Umami 脚本正常加载并发送统计请求
  • 使用 swup 跳转到其他页面:DOM 被替换,但 Umami 脚本可能重新执行
  • 返回原页面:再次触发统计,导致同一访问被重复计算

Umami 脚本在每次执行时会创建新的跟踪实例,而 swup 的页面切换机制没有配合清理旧的实例或阻止重复初始化。这就导致了重复计数,也就是我们本次要解决的问题

其实说这么多只是想在水一篇文章而已

解决办法就是在原来的最终代码中添加data-auto-track="false"属性 参考https://github.com/afoim/fuwari/issues/79

- <script defer src="https://cloud.umami.is/script.js" data-website-id="***"></script>
+ <script defer src="https://cloud.umami.is/script.js" data-website-id="***" data-swup-ignore-script></script>

继续阅读

相关
为 Fuwari 博客添加 Umami 访问量统计

本文介绍如何基于 Umami 逆向 API 为静态博客添加实时访问量统计,包括侧边栏总览卡片和文章独立浏览量。

教程2026-05-24
为你的博客生成封面图吧相关
为你的博客生成封面图吧

基于 afroim/easy_cover 二次开发的博客封面生成工具,新增深色模式、配置保存与导入导出,方便风格复用。

有趣的项目2026-06-06
哎我去这个Pages CMS真神了相关
哎我去这个Pages CMS真神了

通过向你的静态博客仓库导入Pages CMS实现在浏览器里优雅地管理你的文章

教程2026-07-04
随机
一些mmd资源/网站汇总

最近在学习制作mmd,刚好把一些用到的东西贴在这里备忘

分享2026-05-23
随机
博客更新日志

将会记录博客的更新内容。

未分类2026-05-30
随机
Markdown 极其详细测试文档

一份用于测试 Markdown 渲染器语法支持程度的详尽文档,覆盖 CommonMark 核心语法、GFM 扩展与常见的非标准扩展

分享2026-10-02