ReactJS 网站闲置 10-15 分钟后卡死,是否与 Matomo 有关?
结论
现有证据大多指向 Matomo Tag Manager 或容器配置,不过仅凭 development 与 production 的差异,还无法确认唯一根因。
需要重点排查的是同一个 Matomo container、Google Tag Manager 等脚本被反复插入 DOM。容器加载脚本通常只需初始化一次。SPA 路由切换时可以发送新的浏览事件,无需重新加载整个容器。
脚本不断增加可能造成以下问题:
- 重复注册定时器、事件监听器和 History API 钩子
- 重复执行标签及第三方代码
- 持续增加 DOM 节点、网络请求和内存占用
- 主线程长时间执行 JavaScript,最终触发 Chrome 的“site doesn’t respond”提示
页面闲置后,已经重复注册的任务仍可能继续运行,所以脚本持续累积也能解释为什么页面会在闲置 10 到 15 分钟后卡死。
用同一份构建做对照测试
排查时应使用同一份 production build,只改变 Matomo 的加载状态。development 和 production 的构建模式本身存在差异,直接比较很难确认问题是否由 Matomo 引起。
可以准备两组测试:
- production build,正常加载 Matomo。
- 同一个 production build,暂时禁用 Matomo container,或者在浏览器中阻止容器脚本请求。
两组测试使用相同的页面、登录状态和操作过程,各观察 20 到 30 分钟。如果禁用 Matomo 后脚本数量停止增长,页面也不再卡死,基本可以确认两者之间的因果关系。
也可以在 Chrome DevTools 的 Network 面板中屏蔽对应请求,这样暂时不用修改线上代码。测试时仍要确认页面没有通过缓存、Service Worker 或其他标签再次加载同一个脚本。
确认哪些脚本在重复增加
在 Console 中执行:
const scripts = [...document.scripts].map((script) => ({
src: script.src || "[inline]",
id: script.id || "",
}));
console.table(
Object.entries(
scripts.reduce((result, script) => {
const key = script.src;
result[key] = (result[key] || 0) + 1;
return result;
}, {})
)
.filter(([, count]) => count > 1)
.map(([src, count]) => ({ src, count }))
);
还可以定时记录脚本和节点总数:
setInterval(() => {
console.log({
time: new Date().toISOString(),
scripts: document.scripts.length,
nodes: document.getElementsByTagName("*").length,
});
}, 30000);
这段代码仅用于诊断,测试完成后应删除。
如果应用没有直接引入 Google Tag Manager,但它仍出现在 DOM 中,可以从以下位置排查:
- Matomo container 中配置的 Custom HTML 标签
- 容器内加载 GTM 的第三方标签
- 相互加载的多个容器
- 由 History Change、点击或自定义事件触发的“加载容器”类标签
- 在路由切换或组件重新渲染时再次执行 bootstrap 代码的应用逻辑
在 Network 面板中打开重复请求,检查 Initiator 和调用栈。同时使用 Sources 面板的全局搜索查找 googletagmanager.com、_mtm、_paq、Matomo container URL,以及创建 <script> 的代码。
临时追踪 script 的插入来源
如果 Initiator 提供的信息不够,可以在加载 Matomo 前临时加入以下诊断代码:
const originalAppendChild = Node.prototype.appendChild;
Node.prototype.appendChild = function (node) {
if (node instanceof HTMLScriptElement) {
console.group("Script appended");
console.log(node.src || "[inline script]", node);
console.trace();
console.groupEnd();
}
return originalAppendChild.call(this, node);
};
代码会记录通过 appendChild() 注入脚本时的调用栈。有些库使用 insertBefore()、append() 或 document.write(),需要时也可以用同样的方法追踪。
这个补丁会修改全局 DOM 方法,只适合短时间诊断,不能作为生产环境的修复方案。
确保 Matomo loader 只执行一次
一种常见错误是把容器加载代码放进会重复执行的组件、路由监听器,或依赖频繁变化的 useEffect 中,例如:
useEffect(() => {
const script = document.createElement("script");
script.src = MATOMO_CONTAINER_URL;
document.head.appendChild(script);
}, [location]);
这样每次路由变化都会新增一个脚本。即便依赖数组为空,只要组件卸载后重新挂载,脚本仍可能再次加载。
建议把 loader 放在 HTML 模板或应用 bootstrap 中,让它只执行一次。如果必须通过 React 加载,至少要加入全局幂等检查:
let matomoLoadPromise;
export function loadMatomoOnce(containerUrl) {
if (window.__matomoContainerLoaded) {
return Promise.resolve();
}
if (matomoLoadPromise) {
return matomoLoadPromise;
}
matomoLoadPromise = new Promise((resolve, reject) => {
const existing = document.querySelector(
'script[data-matomo-container="true"]'
);
if (existing) {
window.__matomoContainerLoaded = true;
resolve();
return;
}
const script = document.createElement("script");
script.async = true;
script.src = containerUrl;
script.dataset.matomoContainer = "true";
script.addEventListener("load", () => {
window.__matomoContainerLoaded = true;
resolve();
});
script.addEventListener("error", reject);
document.head.appendChild(script);
});
return matomoLoadPromise;
}
useEffect(() => {
loadMatomoOnce(MATOMO_CONTAINER_URL).catch((error) => {
console.error("Failed to load Matomo container", error);
});
}, []);
这层保护只能防止应用重复加载入口脚本。如果 Matomo container 内部的标签配置会循环触发,还需要在 Matomo dashboard 中修改配置。
SPA 路由变化时只发送事件
React Router 切换页面时,应向已经加载的分析系统发送 page view 或自定义事件,无需重新插入 Matomo container。
项目直接使用 Matomo Analytics 的 _paq 队列时,可以采用类似方式:
import { useEffect } from "react";
import { useLocation } from "react-router-dom";
function MatomoPageTracker() {
const location = useLocation();
useEffect(() => {
if (!window._paq) return;
const url = `${location.pathname}${location.search}${location.hash}`;
window._paq.push(["setCustomUrl", url]);
window._paq.push(["setDocumentTitle", document.title]);
window._paq.push(["trackPageView"]);
}, [location]);
return null;
}
如果追踪由 Matomo Tag Manager 管理,则应推送容器约定的 data layer 事件。例如:
window._mtm = window._mtm || [];
window._mtm.push({
event: "spa-page-view",
path: window.location.pathname,
});
spa-page-view 只是示例名称,必须与容器内的 trigger 配置一致。除非现有追踪方案明确要求,否则不要同时通过 _paq 和 Tag Manager 重复发送同一次 page view。
检查 Matomo container 配置
应用代码只是排查范围的一部分。还需要请 Matomo 管理员提供当前已发布 container 的导出配置,或共同核对以下项目:
- 加载 Google Tag Manager 的具体 tag
- tag 使用的 trigger,包括 Page View、History Change、Click 或自定义事件
- 同一事件是否会同时命中多个相同 tag
- 是否有 tag 再次加载当前 Matomo container
- trigger 是否会被 tag 自身产生的事件再次触发,形成循环
- production 实际加载的 container 版本是否与管理员检查的版本一致
- 页面是否从两个不同入口加载了同一个 container
即使 dashboard 中暂时看不出问题,也不能据此排除容器配置,尤其要确认 production 是否还在使用旧的已发布版本。
为什么 React Profiler 看不到异常
React DevTools Profiler 主要记录 React 组件的 render 和 commit。第三方标签通过原生 DOM API 注入脚本、注册监听器或执行长任务时,可能完全绕过 React。因此,Profiler 没有显示明显异常并不意外。
应在问题出现前启动 Chrome Performance 并持续录制一段时间,重点检查:
- Main 线程中的 Long Task
- 反复出现的 Timer Fired 和 Function Call
- 来自 Matomo、GTM 或其他第三方脚本的调用栈
- 持续上升的 DOM Nodes、JS Heap 和 Event Listeners
- 页面闲置时是否仍有较高的 CPU 使用率
可以分别在页面刚打开和接近卡死时,通过 Memory 面板保存 Heap Snapshot,再比较新增对象和 Retainers。也可以使用 Allocation instrumentation on timeline,查找持续分配内存且无法释放的函数。
Chrome 的 Performance Monitor 和浏览器 Task Manager 可以持续显示 CPU、JavaScript memory、DOM nodes 和 event listeners,比单次查看 React render 更适合分析这类累积问题。
继续检查应用代码
如果禁用 Matomo 后问题依旧存在,再集中排查以下部分:
- 应用入口和 Matomo 初始化模块
- 路由监听、导航埋点和点击埋点
- 所有创建
<script>的工具函数 useEffect的依赖项和 cleanup- WebSocket、轮询、heartbeat 及自动刷新逻辑
- 全局
window、document和 History API 监听器 - Redux middleware、订阅函数及持久化插件
- Service Worker 和动态加载脚本的第三方 SDK
提交代码协助分析时,优先提供 Matomo loader、应用入口、路由配置、埋点组件,以及 production 与 development 使用的不同环境配置。整个 Redux store 和无关的业务组件通常无法提供多少帮助。
根据目前的现象,应该先停止容器和 GTM 的重复加载,再检查容器内是否存在循环 trigger。清理 Redux 数据或继续排查 React 无限渲染,可能无法解决当前问题。
备注:内容仅供参考。
