访问与权限
这些错误表示访问或权限问题。请求被阻止的原因，可能是您的 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 消息
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 消息
cdp_error 代码属于上述浏览器与目标网站错误，但它涵盖了多种浏览器端情况。具体原因会在随附的消息中说明：
| 消息 | 建议操作 |
|---|---|
| 浏览器目标或会话已关闭，无法接受命令。 | 修复代码中的脚本错误（通常由缺少 await 语句引起）。 |
CDP 命令使用错误（例如，向 Fetch.dropRequests 传递了无效参数）。 | 核实命令名称及其参数对该 CDP 命令是否有效且格式正确。 |
Chromium 网络错误 (net::ERR_*)
当浏览器无法访问或加载目标网站时，会返回一个以net::ERR_ 为前缀的标准 Chrome 网络错误。这些错误与您在普通 Chrome 浏览器中看到的相同，通常反映目标网站的状态。例如，网站暂时宕机、无法访问或 TLS 证书无效。
错误响应格式：
需要更多帮助？ 如需进一步协助，请联系 support@brightdata.com。