<!-- Capcat 文档「排障：浏览器环境校验」的 Markdown 版本（对应页面 https://capcat.ai/cn/guide/troubleshooting/instrumentation.html）。全部文档索引：https://capcat.ai/llms.txt -->

# 排障：浏览器环境校验

你打开这一页，通常是因为 Capcat 验证组件显示了**错误**并附带「排障」链接。这表示浏览器环境校验没有通过：页面无法确认它运行在一个普通的、由真人操作的浏览器里，因此验证在到达网站之前就被拒绝了。

这与你的身份或账号无关。Capcat 不会要求你识图或输入任何内容，校验只看浏览器本身是否表现得像一个正常浏览器。

## 常见原因

- **自动化工具。** Selenium、Playwright、Puppeteer、浏览器「宏」扩展、应用测试框架都会以程序方式驱动浏览器，受 Capcat 保护的网站默认拒绝这类会话。
- **隐私或反指纹扩展**改写了浏览器属性（例如伪装 `navigator.webdriver`、User-Agent 或插件列表）。出于好意的伪装在校验眼里和自动化没有区别。
- **内嵌或 App 内浏览器**使用了非常规内核、开启了远程调试，或部分禁用了 JavaScript。
- **非常老的浏览器**，或关闭了 WebAssembly、Web Worker 的版本。

## 可以尝试

1. 刷新页面后再点一次复选框。偶发故障（比如标签页被挂起）可能只让校验失败一次。
2. 暂时停用会修改浏览器指纹或拦截脚本的扩展，然后重试。
3. 改用常规的桌面或手机浏览器（Chrome、Edge、Firefox、Safari）打开页面，而不是 App 内置窗口或自动化控制的窗口。
4. 确认该网站允许 JavaScript、WebAssembly 与 Web Worker。
5. 仍然失败时，联系网站管理员并说明 Capcat 组件提示环境校验错误，他们可以调整该站点的防护等级。

## 给站点管理员

发生这种情况时组件会触发 `error` 事件，`code` 为 `instr_blocked`。若你希望放行自动化浏览器（例如内部 QA 站点），可在[控制台](https://console.capcat.ai/cn)里关闭该站点的「拦截自动化浏览器」。也可以用 `data-cap-troubleshooting-url` 属性把链接指向你自己的帮助页。各防护层如何配合见[防护能力](../protection)。

English: [Troubleshooting: browser environment check](https://capcat.ai/guide/troubleshooting/instrumentation)
