怎么找出网站上的 JavaScript 错误？

简短回答

打开 监测 › 错误。真实访问里的脚本错误会被分组，显示次数、涉及的会话和最近发生时间。展开一个分组，能看到每一次发生（时间、页面、位置、设备），并打开对应的会话。处理完就标为「已解决」或「已忽略」。

安装片段里要打开错误采集：data-errors="true"，默认片段已经带上。

1. 确认采集已打开

页顶如果有提示，说明错误采集关着。到 网站统计 › 配置 › SDK 代码，打开「JavaScript 错误」开关，并替换网站上的片段。新片段会带上 data-errors="true"，并额外加载一个小的错误脚本。

<script defer src="https://static.pathclue.com/client.js" data-site="YOUR_SITE_KEY" data-errors="true"></script>

2. 看页面

• 卡片：错误次数、错误率、受影响访客和受影响会话。错误率是所选范围内的错误次数除以页面浏览量。
• 趋势：错误次数随时间的变化；发版之后跳起来，就是那次发版的问题。
• 分组：每种错误一行，显示次数、会话数和最近发生时间。状态分为「活跃」「已解决」和「已忽略」。

3. 逐个处理分组

1. 按受影响的会话数排序，而不只看次数；一个访客反复刷新就能产生很多错误。
2. 展开分组，看是哪些页面、浏览器和设备。只在一个老旧浏览器上出现的错误，未必值得修。
3. 点「打开会话」，看访客在报错前后做了什么。
4. 修复上线后，把分组标为「已解决」。如果再次出现，它会重新变成活跃。

挫败点击

分组下面有一张表，列出点击出了问题的页面：

• 怒点：同一元素 500 毫秒内点击不少于 3 次。
• 错误点击：点击之后 1 秒内出现脚本错误。
• 死点：以后才会采集；这一列目前显示 0。

页面至少有 20 次浏览、并且出现过怒点或错误点击，才会进这张表。比率是（怒点 + 错误点击）÷ 浏览量 × 1,000。怒点依赖全埋点开启。

常见问题

列表是空的，是不是说明没有错误？如果采集没开就不是。看页顶的提示和 data-errors 属性。

有和上一周期的对比吗？没有；改变日期范围来对比。

页面很慢但没有错误？加载速度在另一个报表里，见查看 Core Web Vitals。

能收到提醒吗？监控有按每 1,000 次浏览计算的「挫败点击」条件，见设置流量提醒。

想看人们点在元素的哪个位置，用热力图。背景知识：狂点和用户摩擦。