Browser API 错误代码

本参考页面列出了 Bright Data Browser API 的错误代码，按四个类别分组，并给出每个代码的含义以及建议的操作。当请求失败时，Browser API 会返回一个特定的错误代码。请在下方表格中查找该代码，并按照“建议操作”列执行。

访问与权限

这些错误表示访问或权限问题。请求被阻止的原因，可能是您的 Browser API 区域需要更改配置，也可能是目标受到 Bright Data 合规保护措施的限制。

错误代码	含义	建议操作
`brob`	目标被 robots.txt 阻止。	robots.txt 是目标网站的限制，用于定义爬虫可以访问和不可以访问的内容。如需解除限制，请完成 KYC 验证。
`brul`	目标受 Bright Data 限制。	如需访问被阻止的资源，请通过 compliance@brightdata.com 向合规部门申请权限。
`custom_headers`	客户没有更改标头或 Cookie 的权限。	在您的 Browser API 区域配置中启用 Custom headers and cookies（自定义标头和 Cookie）。
`wrong_customer_name`	用户名无效。	在 Bright Data 控制面板中核实您的用户名是否正确。
`zone_not_found`	指定的区域不存在或未激活。	确认您在 Bright Data 控制面板中使用的是正确且已激活的“Browser API”区域。
`wrong_password`	区域密码不正确。	在 Bright Data 控制面板中核实您的区域密码是否正确。
`missing_credentials`	缺少身份验证凭据。	在您的脚本中添加有效的 Browser API 凭据。

这些错误表示 Browser API 与底层代理网络之间存在路由或连接问题。它们通常发生在代理网络难以建立或维持稳定连接时。

错误代码	含义	建议操作
`no_peers`	无法与对等节点建立连接。	稍后重试，或移除对等节点限制（国家/地区、会话、位置）。
`proxy_no_peer`	无法与对等节点建立连接。	稍后重试，或移除对等节点限制（国家/地区、会话、位置）。
`reserve_no_result`	目标国家/地区没有可用的对等节点。	尝试移除或更改国家/地区定向。
`geo_no_navigation`	导航前无法解析地理位置（在导航到页面前调用 `Proxy.getGeolocation` 时发生）。	先导航到某个页面，然后重试。
`proxy_cooling_peers`	由于分配的对等节点处于冷却期，没有可用的对等节点。	稍后重试，或移除对等节点限制（国家/地区、会话、位置）。
`proxy_no_peers_cooling`	由于分配的对等节点处于冷却期，没有可用的对等节点。	稍后重试，或移除对等节点限制（国家/地区、会话、位置）。
`proxy_timeout`	代理连接超时。	稍后重试。

proxy_error 代码属于上述代理错误，但它涵盖了多种代理端情况。具体原因会在随附的消息中说明：

Browser API 会话有时间限制，以确保最佳性能。当会话运行时间过长、长时间闲置或访问多个域名时，会发生这些错误。为避免这些错误，请将任务拆分为较短的会话，并及时关闭连接。

错误代码	含义	建议操作
`session_timeout`	会话达到 60 分钟上限。	缩短会话时间；拆分为多个会话。
`network_inactivity_timeout`	会话在 5 分钟无网络活动后被终止。	抓取完成后断开与浏览器的连接（对于 WebDriver，还需删除会话）。
`client_timeout`	客户端到浏览器的连接未在规定时间内建立（30 秒）。	检查您的网络连接并重试。
`navigate_domains_limit`	会话仅限于一个域名。	每个域名开启一个新会话。

这些错误发生在浏览器层，原因是脚本命令无效、超时或意外崩溃。如需解决，请调试您的自动化代码或重试会话。

错误代码	含义	建议操作
`cdp_cmd_timeout`	发送给浏览器的命令超时。	重试该命令。
`browser_disconnected`	浏览器因临时内部错误而断开连接。	重试，或建立新会话。
`no_free_workers`	没有可用的浏览器来处理请求。这发生在建立浏览器连接之前，通常表示临时问题。	稍后重试。如果问题持续存在，请联系支持团队。
`worker_disconnect`	浏览器工作节点崩溃，或发生内部基础设施故障。	重试，或建立新会话。
`job_killed`	浏览器会话因基础设施故障而被关闭。	重试，或建立新会话。
`page_navigated_error`	导航过程中发生错误，通常与内部问题有关。	重试，或建立新会话。

cdp_error 代码属于上述浏览器与目标网站错误，但它涵盖了多种浏览器端情况。具体原因会在随附的消息中说明：

消息	建议操作
浏览器目标或会话已关闭，无法接受命令。	修复代码中的脚本错误（通常由缺少 `await` 语句引起）。
CDP 命令使用错误（例如，向 `Fetch.dropRequests` 传递了无效参数）。	核实命令名称及其参数对该 CDP 命令是否有效且格式正确。

当浏览器无法访问或加载目标网站时，会返回一个以 net::ERR_ 为前缀的标准 Chrome 网络错误。这些错误与您在普通 Chrome 浏览器中看到的相同，通常反映目标网站的状态。例如，网站暂时宕机、无法访问或 TLS 证书无效。错误响应格式：

Error: net::ERR_CONNECTION_CLOSED at https://example.com

由于这些是 Chrome 原生错误，可能的代码有很多。要了解特定错误及其原因，请在 source.chromium.org 上搜索确切的错误名称。

需要更多帮助？ 如需进一步协助，请联系 support@brightdata.com。