PAYATHON 2026

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 引起。

可以准备两组测试:

  1. production build,正常加载 Matomo。
  2. 同一个 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 无限渲染,可能无法解决当前问题。

备注:内容仅供参考。