For the complete documentation index, see llms.txt. This page is also available as Markdown.

故障排除指南

了解在使用无头浏览器时如何处理意外行为或较低成功率。

症状
可能原因
解决方案

401 无效凭据(凭据实际上是正确的)

使用 ws:// 协议

切换为 wss://

401 无效凭据

用户名 无后缀

使用仪表板中的后缀令牌的完整用户名(例如, _ab12)

CDP_SESSION_RATE_LIMIT_REACHED

你尝试每秒启动过多浏览器

请保持在 10 每秒会话限制内,或 联系支持 以提高上限。

CDP_MAX_CONCURRENT_SESSIONS_REACHED

你的活动会话数已达到限制

保持在 100 并发会话总数之内,或 联系支持 以提高上限。

会话检查(VNC)无法连接(浏览器已启动)

已达到 VNC 最大限制

减少 VNC 会话数量。

TLS / 证书错误

Node.js 中的证书验证

设置 NODE_TLS_REJECT_UNAUTHORIZED="0" 在 require Playwright 之前设置(仅用于测试)。

CDP_LIMIT_REACHED:已达到配置文件限制

o_profile 数量超过 max_profiles (默认: 5)

复用一个稳定的配置文件名称,删除仪表板(hb.oxylabs.io/dashboard)中未使用的配置文件,或 联系支持 以提高上限。

400 session_name 必须为 3-36 个字母数字字符或 '-'

session_name 中存在下划线或无效字符 session_name

仅使用字母、数字和连字符([A-Za-z0-9-]).

配置文件已恢复,但 Cookie 为空

会话之间出口 IP 发生变化

固定 proxy_resi_ses_id + proxy_resi_ses_time 为每次会话相同的值。

登录墙 / 成功率低

IP 信誉、地理位置错误或引擎不匹配

设置 p_cc (+ p_city),尝试其他 p_device,或在新会话中重试。

目标完全被阻止

受限目标类别

通过您的专属客户经理完成 KYC。

仍然卡住?通过在线聊天或电子邮件联系 Oxylabs 支持(support@oxylabs.io).

如果您遇到意外行为或成功率较低,请考虑以下步骤:

了解我们的 CAPTCHA 处理流程

熟悉我们的 CAPTCHA 处理 方法及其使用方式。这可以帮助判断 CAPTCHA 挑战是否是问题的来源。

使用国家参数

在请求中指定国家参数可以显著提高成功率。这可确保您的请求通过来自特定地理位置的 IP 路由,并过滤掉来自随机或可能不太可靠位置的 IP。

您可以通过在连接 URL 中添加 ?p_cc 参数来为浏览器会话指定国家。更多信息可参见 地理位置定位.

使用设备类型参数

尝试设备参数可带来更高的成功率。您可以通过使用 ?p_device 参数来自定义浏览器模拟不同设备类型的方式。更多信息可参见 设备类型 部分。

如果尝试这些步骤后问题仍然存在,请联系您的专属客户经理,并提供问题详情以及您已经采取的步骤。

需要启用某项功能?

某些无头浏览器功能默认受限。要调整限制,请联系 Oxylabs 支持(在线聊天电子邮件)或您的专属客户经理:

  • 更多持久化配置文件 – 提高您账户默认的 5 个已保存配置文件上限。

  • 更多持久化会话 – 提高您账户默认的 5 个并发持久化会话上限。

  • 受限目标 – 通过 KYC 流程解锁更多目标类别。

  • 更高的速率限制 – 提升到超过 100 个并发会话 / 每秒 10 个。

最后更新于

这有帮助吗?