跳转到内容
BugCapturer BugCapturer Docs

SDK 与插件排错

不用通读文档——直接对症状。下表覆盖 Web SDK（悬浮球）与浏览器插件最常见的问题；每一行都指向更详细的专门文档。

症状对照表

Section titled “症状对照表”
症状可能原因处置
悬浮球始终不出现sdk_key 无效；项目被暂停；页面 CSP 拦截了脚本；域名不在白名单在控制台确认项目状态正常；检查域名白名单是否包含当前域名；打开浏览器控制台看有没有脚本加载报错
悬浮球出现但截图空白 / 缺内容页面包含跨域 iframe 或 Canvas 内容，受浏览器安全策略限制属于已知的降级场景；测试者也可以改用插件截图
提交返回 403当前页面主机不在项目的域名白名单在控制台检查域名白名单：精确匹配或一级通配 *.example.com
提交返回 429触发了项目或 IP 的每日限流属于保护性限流，次日恢复；持续出现说明正常用量超出配额，联系我们调整
插件已安装但点了没反应安装后页面未刷新；扩展未重载；浏览器版本过旧刷新页面；在 chrome://extensions 点「重新加载」；确认 Chrome 111+
表格里没有新行该站点未绑定集成路由；集成被连续失败自动停用在「设置 → 集成」查看投递日志定位失败原因；被停用的按自动停用与恢复修复后重新启用
分享链接打不开超过保留期自动清理；被所有者删除链接失效不可恢复，请分享者重新生成；保留期规则见数据流、存储与保留期

快速自查三步

Section titled “快速自查三步”

不管遇到什么症状，先做这三件事能解决大半问题：

  1. 刷新页面 —— 装完插件、改完配置后，旧页面不会自动生效
  2. 确认账号与项目状态 —— 控制台里项目是否正常、邮箱是否已验证
  3. 看日志 —— 集成问题看投递日志；SDK 问题看浏览器控制台的报错信息

还是不行？

Section titled “还是不行？”

带着信息联系我们（见服务状态与联系支持）：页面 URL、使用的插件或 SDK 版本、完整报错信息、一张截图。有这些信息我们基本能在第一轮回复里给出答案。

延伸阅读

Section titled “延伸阅读”