本文介绍如何区分代理错误与其他错误，如何分析错误，以及如何排查并解决使用 Bright Data 代理服务时遇到的问题。

我如何查看 Bright Data 代理服务的健康状态？

Bright Data 会在此页面发布其产品与服务状态： https://www.bright.cn/network-status 。在此页面，你可以查看你所使用的产品或全球可用性是否存在问题或事件。你还可以注册电子邮件提醒，当可用性变化或出现大范围事件时将收到通知。

如果我发现正在使用的代理网络存在当前事件，该怎么办？

首先，你需要检查你的业务是否受到影响。两个主要指标是响应时间下降（变慢）或错误率上升。如果出现其中任何一种情况，请降低处理速率，并继续下一步排查问题。

如何判断我遇到的错误是否来自 Bright Data 代理？

在使用代理时，你可能会遇到并非由 Bright Data 引起的错误。要识别错误来源，请检查响应头中是否包含 Bright Data 的错误字段，我们在这些字段中按代理层级覆盖了大多数错误。如果你仍无法访问目标网站，或收到 HTTP 状态 200 但没有预期数据，则很可能已被目标网站屏蔽。在本文：突破网站封锁中，我们提供了一些最佳实践。

在其他软件中测试 Bright Data 代理时出现 “Proxy Error” 如何解决？

许多软件工具与实用程序使用 Bright Data 代理，并提供 “Test proxy” 功能。当你点击 “Test proxy” 并看到通用的 “Proxy Error” 错误时，该问题可能来自多种原因。

常见问题与解决方案

目标为搜索引擎如 google.com 或 bing.com：Bright Data 限制通过代理网络访问搜索引擎。要解决此问题，请进入软件设置并将测试网址更改为： https://geo.brdtest.com/welcome.txt
使用住宅代理网络但未安装证书：Bright Data 不允许在未通过 KYC 或未安装证书的情况下使用住宅代理网络。请阅读不同的访问模式： Residential Network Access Policy.

Bright Data 代理错误排查

Bright Data 的代理错误格式与标准现支持 RFC9209

自 2025 年 10 月起，Bright Data 在响应负载中支持两组用于传递代理错误的头字段：

私有的 x-brd-* 字段：x-brd-err-code 与 x-brd-err-msg
标准 RFC9209 的 Proxy-Status 响应头格式。

Proxy-Status 标准字段将在 2026 年逐步替代所有 x-brd-* 字段。

什么是 RFC9209？

RFC9209 是关于如何在代理响应头中传递代理错误的标准。Bright Data 正在采用该标准并将其应用于所有错误目录。这将帮助客户代码与使用代理作为基础设施的第三方工具更快识别和解决代理交互问题。你可以在此处了解更多内容： The Proxy-Status HTTP Response Header

如何实现 RFC9209？

Proxy-Status HTTP 头示例

Proxy-Status: brd.brighdata.io;
received-status=400;
error=destination_ip_unroutable;
details="client-10060: Requested IP ##.##.##.## is not allocated to this zone. Select an IP that is allocated to this zone or skip the -ip parameter in proxy username."

实现说明

解析响应头：确保你的系统能够解析 HTTP 响应中的 Proxy-Status 头。
提取相关字段：
- received-status：提供收到的 HTTP 状态码
- error：描述遇到的核心错误
- details：包含具体错误代码及进一步信息
- 中第一个字段为 Bright Data 错误代码（如 client_10060）并以冒号分隔
- 你可以直接使用此前缀浏览错误文档：
  https://docs.brightdata.com/cn/proxy-networks/errorCatalog#[Bright data error code]
  示例 client_10060：
  https://docs.brightdata.com/cn/proxy-networks/errorCatalog#client_10060
根据这些结构化代码调整错误处理流程，以改进调试效率并确保代理正常运行。

Bright Data HTTP 代理头字段

以下字段在发送 HTTP 或 HTTPS 请求时返回：

Field	Description	Examples	REST API Field Name
`HTTP Error`	协议错误码	`404` 或 `502`	`status_code`
`x-brd-err-code`	Bright Data 模块与错误代码	`client_10001`	`error_code`
`x-brd-error`	Bright Data 主错误信息	Authentication failed	`error`
`x-brd-err-msg`	Bright Data 详细错误与操作建议	Authentication failed. Please check your credentials or review your account status and billing settings.	`error_message`
`Proxy-Status`	RFC9209 兼容响应头，包括代理服务器、HTTP 状态和指向 Bright Data 错误代码的详情字符串	`Proxy-Status: brd.superproxy.io; received-status=407; error="http_request_denied"; details="client_10000: Invalid authentication: check credentials and retry. Bright Data credentials include your account ID, zone name and password"`	Not supported

获取 HTTP 头字段

从命令行测试

你可以在 shell 终端使用 curl 命令并加上 -v 或 -i 查看设置或复现问题。这些选项会打印所有头字段，包括自定义错误代码与消息。

curl -v [rest of curl command options]

若想仅查看响应头，可使用：

curl -i [rest of curl command options]

你也可以使用 nc 命令打印字段：

echo "[tcp nc inputs]" | nc -C -v brd.superproxy.io 44445

nc 输入中可能包含 “空行”，这些对于正确测试是必需的。

`curl` 命令片段

你所使用 zone 的 Overview 标签中提供包含全部参数的 curl 命令片段。

通过编程语言访问

Bright Data HTTP 头字段可如同其他 HTTP 头一样在你的程序中读取。

通过 Bright Data 的 Proxy REST API 访问

Bright Data 提供 REST API 以访问代理网络、Web Unlocker API 和 SERP。字段名称略有不同，但内容完全一致。示例响应：

"status_code": 407,
"status_message": "Proxy Authentication Required",
"error": "Proxy Authentication Required",
"error_message": "No proxy credentials provided. Please add credentials and try again.",
"error_code": "client_10010"

错误目录

下表列出代理实际返回的字符串，便于你与自己的日志逐项比对。

x-brd-error 为简短错误描述。少数错误不设置该响应头，此时表中给出的是 HTTP 状态消息。
x-brd-err-msg 为详细说明与处理建议。
Proxy-Status 错误类型 为 Proxy-Status 响应头中返回的 RFC 9209 错误类型。“未设置”表示该错误不返回该字段。

%HOST%、%IP%、%ZONE%、%COUNTRY%、%PORT%、%DOMAIN% 等占位符会在运行时替换为你的请求详情。

HTTP 错误 400

当你在使用 Data Center / ISP 或 gIPs 产品并使用 -ip-x.x.x.x 定向标记时，如果你所在 Zone 下的 IP 因系统更新被刷新、移除或变更，就可能出现 400 错误码。

这个错误通常会在你的 Bright Data 账户最近被暂停后出现。如果账户余额变为负数，系统会自动暂停账户。如果暂停超过 24 小时，你的静态分配 IP 将会被释放。账户恢复后，重新分配的 IP 可能与之前不同，因此如果你的请求仍然指定旧的 IP，就会触发此错误。

当出现此错误时，请前往 Bright Data 的 Zones 页面，查看该 Zone 最新的可用 IP 列表。

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`client_10060`	`Proxy Error: ip_requested_not_allocated_by_customer`	请求的 IP `%IP%` 未分配给该 Zone。请选择分配给该 Zone 的 IP，或在代理用户名中移除 `-ip` 参数。	`destination_ip_unroutable`
`client_10061`	未设置，HTTP 状态消息为 `Peer not found`	在所选默认国家 `%COUNTRY%` 中未找到代理。请修改默认国家选择，或使用 -country 参数指定其他国家以覆盖默认设置。详见：https://docs.brightdata.com/api-reference/proxy/geolocation-targeting	`destination_ip_unroutable`
`client_10062`	未设置，HTTP 状态消息为 `No IPs in selected country`	所选国家 `%COUNTRY%` 没有可用 IP。请尝试其他国家，或省略 -country 认证参数。详见：https://docs.brightdata.com/api-reference/proxy/geolocation-targeting	`destination_ip_unroutable`
`client_10063`	未设置，HTTP 状态消息为 `Bad IP format`	提供的 IP 地址 `%IP%` 为空，或不符合 IPv4 或 IPv6 协议。请检查输入后重试。	`destination_ip_unroutable`
`client_10064`	`Proxy Error`	分配给该持久会话的 IP 不可用。请使用相同的会话 ID 重试请求，或使用新的会话 ID 获取新 IP。	`destination_ip_unroutable`

client_10060：当请求未指定具体 IP 时，同一错误码返回的消息为“No available IPs could be allocated in this zone. Please try again later or contact support.” client_10062：在 Datacenter 或 ISP zone 上，同一错误码返回的是 zone 专属消息：“Your shared 或 dedicated DC 或 ISP zone does not have IPs in selected countries. Either IPs location has changed, or zone not configured with proxies in selected countries. Check zone configuration and try again with relevant country code.”

HTTP 错误 401

以下是 HTTP 401 错误对应的 x-brd-err-code 值：

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`client_10050`	`Auth Failed (code: ip_blacklisted)`	你发送该请求所用的 IP 地址 `%IP%` 已被加入该 Zone 设置的拒绝列表。请从“Blocked IPs”列表中移除 `%SUBNET%`：`https://brightdata.com/cp/zones/%ZONE%/access_params?id=%ACCOUNT_ID%`	`destination_ip_prohibited`

参考：FAQ：如何设置允许/拒绝名单？

HTTP 错误 402

以下为 HTTP 402 错误对应的 x-brd-err-code：

以下 402 错误适用于 2026 年 7 月 7 日（含）之前创建的住宅区域，并对这些现有区域持续有效。它们不适用于 2026 年 7 月 7 日之后创建的住宅区域（这些区域需要 KYC）。参见住宅网络访问政策。

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`policy_20130`	Residential Failed (`bad_endpoint`)：请求的网站在即时 Residential（无 KYC）访问模式下不可用，因为 `%HTTP_METHOD%` 请求不被允许。如需针对该站点获得完整 Residential 访问权限，请填写 KYC 表单：https://www.bright.cn/cp/kyc	同 `x-brd-error`	`destination_ip_prohibited`
`policy_20140`	Residential Failed (`bad_endpoint`)：根据 robots.txt，请求的网站在即时 Residential（无 KYC）访问模式下不可用。如需针对该站点获得完整 Residential 访问权限，请填写 KYC 表单：https://www.bright.cn/cp/kyc	同 `x-brd-error`	`destination_ip_prohibited`

在分销商账户下，上述两条 402 消息中的 KYC 链接指向该分销商自有的 KYC 表单，而非 brightdata.com/cp/kyc。

HTTP 错误 403

HTTP 403 表示你正在访问一个有效 URL，但访问被禁止。服务器处理了请求，但无法返回结果，可能是请求格式错误或者被 Bright Data 策略所限制。

kyc_required 和 business_account_required 不是代理错误。在未完成所需验证的情况下创建 Residential zone 时，Account Management API 会返回这两个错误。参见添加 zone 中的“Residential 403 合规错误”。

以下是 HTTP 403 对应的 x-brd-err-code：

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`client_10070`	No Protocol	原始请求中缺少协议。请添加 HTTP 或 HTTPS 后重试。	`http_protocol_error`
`client_10080`	No Destination Host	缺少目标主机，或目标主机不正确。请检查请求参数后重试。	`http_request_error`
`client_10090`	你正在尝试将 Scraping Browser zone 当作普通代理使用。	你正在尝试将 Scraping Browser zone 当作普通代理使用。该 zone 必须通过浏览器访问。访问方式参见 Browser API。	`http_request_denied`
`client_10130`	禁止访问：该 super proxy 仅允许通过中国代理访问中国域名。其他情况请使用 `brd.superproxy.io`。详见：`https://docs.brightdata.com/proxy-networks/mobile/faqs#how-to-browse-chinese-sites-by-using-chinese-residentials-ips`	同 `x-brd-error`	`http_request_denied`
`client_10250`	禁止访问：你尝试访问 `%HOST%` 但被阻止	你尝试访问 `%HOST%` 但被阻止，因为该主机不在该 zone 允许列表安全设置的允许目标中。请将该主机加入允许列表，或清空允许列表以允许全部目标。	`http_request_denied`
`client_10260`	禁止访问：你尝试访问 `%HOST%` 但被阻止	你尝试访问 `%HOST%` 但被阻止，因为该主机在该 zone 拒绝列表安全设置中被显式阻止。请将该主机从拒绝列表中移除，或清空拒绝列表以允许全部目标。	`http_request_denied`
`policy_20000`	访问被拒绝：`%HOST%` 被分类为 `%CATEGORY%` 并被 Bright Data 阻止	访问被拒绝：`%HOST%` 被分类为 `%CATEGORY%`，并因可能违反 Bright Data 使用政策而被 Bright Data 阻止。详见：https://docs.brightdata.com/proxy-networks/residential/network-access#residential-proxy-network-policy	`http_request_denied`
`policy_20010`	Bad Protocol	Bright Data 将 443 端口限制为仅用于 HTTPS 协议。请修正你的协议或端口后重试。	`http_protocol_error`
`policy_20020`	Bad Port	使用了错误的端口。支持的端口参见：https://docs.brightdata.com/proxy-networks/faqs#how-to-see-supported-ports-and-protocols	`http_request_error`
`policy_20021`	目标端口 `%PORT%` 被 Bright Data 阻止，不允许用于 superproxy 请求	由于合规策略，请求被重新路由到 superproxy，但随后被阻止，因为目标端口 `%PORT%` 不允许来自 superproxy 的请求	`destination_direct_port_prohibited`
`policy_20031`	禁止访问：目标 `%HOST%` 被阻止	目标 `%HOST%` 被 Bright Data 阻止。该目标主机提供与 Bright Data 相关的网络服务或信息，因此无法通过 Bright Data 代理访问。如需进一步协助，请联系 support@brightdata.com	`connection_refused`
`policy_20032`	禁止访问：目标 `%HOST%` 被阻止	与 `policy_20031` 条件相同，适用于隧道请求。目标 `%HOST%` 被 Bright Data 阻止。该目标主机提供与 Bright Data 相关的网络服务或信息，因此无法通过 Bright Data 代理访问。如需进一步协助，请联系 support@brightdata.com	`connection_refused`
`policy_20040`	目标主机根据 Bright Data 合规政策被阻止	目标主机根据 Bright Data 合规政策被阻止	`destination_ip_prohibited`
`policy_20050`	禁止访问：目标站点需要特殊权限。请联系 Bright Data 获取协助	禁止访问：目标站点需要特殊权限。你正在尝试访问一个不被我们合规政策允许的目标站点。如需获得访问权限，你可能需要完成 KYC 流程，请填写表单：https://www.bright.cn/cp/kyc。如果你已经完成 KYC 审批，请联系你的客户经理了解详情。	`destination_ip_prohibited`
`policy_20051`	禁止访问：目标站点需要特殊权限。请联系 Bright Data 获取协助	禁止访问：该目标站点为政府网站，需要特殊权限才能访问。如需获得访问权限，你可能需要完成 KYC 流程，请填写表单：https://www.bright.cn/cp/kyc。如果你已经完成 KYC 审批，请联系你的客户经理了解详情。	`destination_ip_unroutable`
`policy_20052`	禁止访问：目标站点无法通过所选网络访问。请联系 Bright Data 获取协助	禁止访问：由于合规政策，所选网络类型限制访问此站点。请尝试切换到其他网络类型。如需在同一网络获得访问权限，你可能需要完成 KYC 流程，请填写表单：https://www.bright.cn/cp/kyc。如果你已经完成 KYC 审批，请联系你的客户经理了解详情。	`destination_ip_prohibited`
`policy_20060`	禁止访问：`%HOST%`	禁止访问：`%HOST%`。你尝试访问的 `%HOST%` 被 Bright Data 政策阻止。	`connection_refused`
`policy_20080`	禁止访问：该请求必须使用住宅代理网络	你正在访问一个不允许通过 Bright Data 数据中心或 ISP 网络访问的域名。请使用 Residential（住宅）网络 zone 重试请求。	`connection_refused`
`policy_20090`	禁止访问：该域名的请求被阻止	禁止访问：该域名的请求在当前代理网络上被阻止。请通过 Unlocker zone 或 IDE 工具获取访问权限，或联系你的客户经理获取进一步协助	`connection_terminated`
`policy_20091`	目标 `%HOST%` 在 IPv6 上被 Bright Data 阻止。	目标 `%HOST%` 在 IPv6 协议下被 Bright Data 阻止。请尝试使用 IPv4 代理，或使用我们的 Unlocker 访问该目标。	`destination_ip_prohibited`
`policy_20100`	禁止访问：该域名的请求在代理网络上被阻止，请通过 Unlocker zone 或 IDE 工具获取访问权限，或联系你的客户经理获取协助	同 `x-brd-error`	`connection_refused`
`policy_20110`	禁止访问：该域名的请求在数据中心和 ISP 代理网络上被阻止，请通过 SERP API zone 获取访问权限，或联系你的客户经理获取协助	同 `x-brd-error`	`connection_refused`
`policy_20230`	`%COUNTRY%` 不允许作为目标国家，请修改为其他国家	`%COUNTRY%` 不允许作为目标国家，请修改为其他国家	`connection_refused`
`policy_20240`	代理端口 `%PORT%` 已被限制。请联系 Bright Data 支持	代理端口 `%PORT%` 已被限制。请联系 Bright Data 支持	`http_request_denied`
`policy_20250`	禁止访问：你尝试访问 `%HOST%` 但被阻止	该域名被你账户的根允许列表禁止。你尝试访问 `%HOST%` 但被 Bright Data 政策设置阻止。该站点可能被 Bright Data 政策禁止，或你的账户没有访问该站点的权限。	`destination_ip_prohibited`
`policy_20251`	禁止访问：你尝试访问 `%HOST%` 但被阻止	该域名被该 zone 的根允许列表禁止。你尝试访问 `%HOST%` 但被 Bright Data 政策设置阻止。该站点可能被 Bright Data 政策禁止，或你的账户没有访问该站点的权限。	`destination_ip_prohibited`
`policy_20260`	禁止访问：你尝试访问 `%HOST%` 但被阻止	该域名在你账户的根拒绝列表中。你尝试访问 `%HOST%` 但被 Bright Data 政策设置阻止。该站点可能被 Bright Data 政策禁止，或你的账户没有访问该站点的权限。	`destination_ip_prohibited`
`policy_20261`	禁止访问：你尝试访问 `%HOST%` 但被阻止	该域名在该 zone 的根拒绝列表中。你尝试访问 `%HOST%` 但被 Bright Data 政策设置阻止。该站点可能被 Bright Data 政策禁止，或你的账户没有访问该站点的权限。	`destination_ip_prohibited`

client_10090：代理返回的消息中使用旧产品名 “Scraping Browser”，Browser API 是同一产品的当前名称。 policy_20040：请在 zone 设置中检查该域名是否允许作为该 zone 的目标。

HTTP 错误 407

HTTP 407 表示认证失败，可能是凭据错误，或账户被暂停。

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`client_10000`	Authentication failed	密码错误：认证无效，请检查凭据后重试。Bright Data 凭据包括你的账户 ID、zone 名称和密码。登录控制面板可查看或修改该 zone 的密码	`http_request_denied`
`client_10000`	Authentication failed	账户 ID 错误：认证无效，请检查凭据后重试。Bright Data 凭据包括你的账户 ID、zone 名称和密码	`http_request_denied`
`client_10001`	未设置，HTTP 状态消息为 `Invalid Auth`	认证无效，请检查凭据后重试。Bright Data 凭据包括你的账户 ID、zone 名称和密码	未设置
`client_10002`	未设置，HTTP 状态消息为 `Zone not found`	认证失败：未找到 zone。所用 zone 名称拼写错误，或该 zone 已禁用或已删除。请检查输入，并在 Bright Data 控制面板中确认该 zone 状态为 “Active”，或使用 API 查询当前 zone 状态：Get active zones	`http_request_denied`
`client_10010`	未设置，HTTP 状态消息为 `Proxy Authentication Required`	未提供代理凭据。请补充凭据后重试。	`http_request_denied`
`client_10020`	账户已暂停。请登录 brightdata.com/cp/setting/billing 激活你的账户	账户已暂停。请登录 brightdata.com/cp/setting/billing 激活你的账户	`http_request_denied`
`client_10030`	`Auth Failed (code: ip_forbidden)`	你发送该请求所用的 IP 地址 `%IP%` 不在该 zone 设置的允许列表中。请将其加入 “Allowed IPs” 列表：`https://brightdata.com/cp/zones/%ZONE%/access_params?id=%ACCOUNT_ID%`	`http_request_denied`
`client_10030`	Authentication failed	不允许通过该 IP（`%IP%`）访问我们的 API。请检查你的设置，或将该 IP 加入允许列表。	`http_request_denied`
`client_10040`	需要完成 KYC。请访问 brightdata.com/cp/kyc 并确认你已通过验证	需要完成 KYC。请访问 brightdata.com/cp/kyc 并确认你已通过验证	`http_request_denied`
`policy_20120`	IP 参数 `%IP%` 不正确，请在 IP 参数中使用 x-brd-ip header 格式	IP 参数 `%IP%` 不正确，请在 IP 参数中使用 x-brd-ip header 格式	`connection_refused`

client_10000 和 client_10030 各自对应两种情况，错误码相同，仅 x-brd-err-msg 不同。

HTTP 错误 408

HTTP 408 表示访问目标网站超时，可能是目标网站有误、网络延迟或被阻止。

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`peer_30040`	Peer did not connect to destination due timeout	代理节点因超时未能连接到目标。	`connection_timeout`

HTTP 错误 429

如果你使用的是未充值账户，可能会触及每分钟 1,000 次请求的默认速率限制。你可以在控制面板中查看当前应用的限制，路径为该区域的“概览 (Overview)”选项卡 > 访问详情 (Access details)。向账户充值后，此默认限制将被移除。

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`client_10110`	你的账户已超出允许的速率限制。请降低请求速率后重试，或完成验证流程以移除速率限制。此次请求不会计费。	同 `x-brd-error`	`http_request_denied`
`policy_20220`	域名 `%DOMAIN%` 已达到速率上限。Bright Data 的健康监控正在限流这些请求，以避免目标网站过载	同 `x-brd-error`	`connection_refused`
`policy_20221`	对 `%HOST%` 的请求速率过高	对 `%HOST%` 的请求速率过高	`connection_refused`
`policy_20222`	zone `%ZONE%` 上单 IP `%IP%` 已达到速率上限。请求正在被限流以避免过载。请增加 IP 数量或降低请求速率，并检查你的轮换逻辑以及响应体积是否异常增大，以确保请求和带宽在该 zone 的各 IP 之间均匀分布。	同 `x-brd-error`	`connection_refused`
`policy_20223`	对 `%DOMAIN%` 的请求受速率限制	对 `%DOMAIN%` 的请求受速率限制。Bright Data 检测到该域名的成功率下降，正在着手解决。建议你在我们逐步解除限制期间重试失败的请求，或降低请求速率后稍后再试	未设置

policy_20221 在对目标主机 %HOST% 的请求速率过高时返回。请降低对该主机的请求速率后重试。如果目标是 IP 地理位置服务，请改用 Bright Data 自有接口：https://geo.brdtest.com/mygeo.json。 policy_20223 在 Bright Data 因某域名成功率下降而应用自适应速率限制时返回。该限制会动态调整，因此重试失败的请求属于预期行为，并有助于在成功率恢复后更快解除限制。

HTTP 错误 499

以下是 HTTP 499 错误对应的 x-brd-err-code：

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`client_10140`	未设置，HTTP 状态消息为 `Client disconnect`	客户端在响应完整返回之前关闭了与代理的连接。通常由客户端超时、请求被取消或本地网络中断引起。请检查客户端超时配置，并确保客户端等待足够长的时间以接收代理响应。	`http_request_error`

HTTP 错误 502

以下是 HTTP 502 错误对应的 x-brd-err-code：

错误代码	`x-brd-error`	`x-brd-err-msg`	`Proxy-Status` 错误类型
`client_10100`	未设置，HTTP 状态消息为 `Zone has reached usage limit`	该 zone 已达到使用限制。请前往 https://brightdata.com/cp/zones 移除或修改限制	`http_request_denied`
`client_10120`	未设置，HTTP 状态消息为 `Block direct route`	请求重路由被阻止。你选择了在请求失败时不通过 superproxy 重路由，因此重路由被阻止。	`http_request_denied`
`peer_30030`	Proxy Error: We do not have proxies in the city you requested	代理错误：你请求的城市没有可用代理，请检查拼写或稍后重试。城市定向的正确用法参见：https://docs.brightdata.com/proxy-networks/faqs#how-to-target-a-specific-city	`destination_ip_unroutable`
`policy_20070`	Host is blocked in requested country	你尝试访问的主机在所请求的国家被阻止。请更换国家后重试。	`http_request_error`
`target_40001`	Could not resolve host `%HOST%`	无法解析主机 `%HOST%`。请检查主机名拼写是否正确后重试。如果拼写无误，或该主机只能从特定地区解析，请联系 Bright Data 支持获取 DNS 协助。	`dns_error`
`target_40011`	将 `%HOST%` 解析为 IPv6 失败。这通常是因为你所定向的主机没有发布 IPv6 地址。请改用 IPv4 代理重试请求。	同 `x-brd-error`	`dns_error`
`target_40020`	Destination host connect timeout	连接目标主机 `%HOST%:%PORT%` 超时。目标服务器未在规定时间内响应，可能表示服务器已下线、过载或正在阻止连接。请确认目标 URL 和端口是否正确后重试。	`connection_timeout`
`target_40021`	Destination host connect timeout	与 `target_40020` 条件相同，适用于 Residential zone。连接目标主机 `%HOST%:%PORT%` 超时。目标服务器未在规定时间内响应，可能表示服务器已下线、过载或正在阻止连接。请确认目标 URL 和端口是否正确后重试。	`connection_timeout`
`internal_50010`	未设置，HTTP 状态消息为 `Bad Gateway`	Proxy Error	未设置

client_10120：如需更改该行为，参见 Request error handling。 internal_50010 在代理发生内部错误时返回。请重试该请求，如果问题持续，请附上时间戳联系 support@brightdata.com。

开始使用

数据提取

网页搜索

AI 训练数据

代理网络

代理错误排查

我如何查看 Bright Data 代理服务的健康状态？

如果我发现正在使用的代理网络存在当前事件，该怎么办？

如何判断我遇到的错误是否来自 Bright Data 代理？

在其他软件中测试 Bright Data 代理时出现 “Proxy Error” 如何解决？

常见问题与解决方案

Bright Data 代理错误排查

Bright Data 的代理错误格式与标准现支持 RFC9209

什么是 RFC9209？

如何实现 RFC9209？

Proxy-Status HTTP 头示例

实现说明

Bright Data HTTP 代理头字段

获取 HTTP 头字段

从命令行测试

`curl` 命令片段

通过编程语言访问

通过 Bright Data 的 Proxy REST API 访问

错误目录

HTTP 错误 400

HTTP 错误 401

HTTP 错误 402

HTTP 错误 403

HTTP 错误 407

HTTP 错误 408

HTTP 错误 429

HTTP 错误 499

HTTP 错误 502

​我如何查看 Bright Data 代理服务的健康状态？

​如果我发现正在使用的代理网络存在当前事件，该怎么办？

​如何判断我遇到的错误是否来自 Bright Data 代理？

​在其他软件中测试 Bright Data 代理时出现 “Proxy Error” 如何解决？

​常见问题与解决方案

​Bright Data 代理错误排查

​Bright Data 的代理错误格式与标准现支持 RFC9209

​什么是 RFC9209？

​如何实现 RFC9209？

​Proxy-Status HTTP 头示例

​实现说明

​Bright Data HTTP 代理头字段

​获取 HTTP 头字段

​从命令行测试

​curl 命令片段

​通过编程语言访问

​通过 Bright Data 的 Proxy REST API 访问

​错误目录

​HTTP 错误 400

​HTTP 错误 401

​HTTP 错误 402

​HTTP 错误 403

​HTTP 错误 407

​HTTP 错误 408

​HTTP 错误 429

​HTTP 错误 499

​HTTP 错误 502

我如何查看 Bright Data 代理服务的健康状态？

如果我发现正在使用的代理网络存在当前事件，该怎么办？

如何判断我遇到的错误是否来自 Bright Data 代理？

在其他软件中测试 Bright Data 代理时出现 “Proxy Error” 如何解决？

常见问题与解决方案

Bright Data 代理错误排查

Bright Data 的代理错误格式与标准现支持 RFC9209

什么是 RFC9209？

如何实现 RFC9209？

Proxy-Status HTTP 头示例

实现说明

Bright Data HTTP 代理头字段

获取 HTTP 头字段

从命令行测试

`curl` 命令片段

通过编程语言访问

通过 Bright Data 的 Proxy REST API 访问

错误目录

HTTP 错误 400

HTTP 错误 401

HTTP 错误 402

HTTP 错误 403

HTTP 错误 407

HTTP 错误 408

HTTP 错误 429

HTTP 错误 499

HTTP 错误 502