故障排除指南

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

症状	可能原因	解决方案
401 凭据无效（凭据是正确的）	使用 ws:// 方案	切换到 wss://
401 凭据无效	裸 用户名 无后缀	使用带有仪表板中后缀 token 的完整用户名（例如， _ab12)
CDP_SESSION_RATE_LIMIT_REACHED	您尝试每秒启动的浏览器数量过多	保持在 10 每秒会话限制内，或 联系支持 以提高上限。
CDP_MAX_CONCURRENT_SESSIONS_REACHED	您当前的活动会话数已达到上限	保持低于 100 并发会话总数，或 联系支持 以提高上限。
会话检查（VNC）无法连接（浏览器已启动）	已达到 VNC 最大限制	使用更少的 VNC 会话。
TLS / 证书错误	Node.js 中的证书验证	设置 NODE_TLS_REJECT_UNAUTHORIZED="0" 在引入 Playwright 之前（仅用于测试）。
CDP_LIMIT_REACHED: 已达到配置文件上限	o_profile 计数超过 max_profiles （默认： 5)	重复使用一个稳定的配置文件名称，在 Dashboard（hb.oxylabs.io/dashboard）中删除未使用的配置文件，或 联系支持 以提高上限。
400 session_name 必须为 3-36 位字母数字字符或 '-'	在 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 支持（[e-mail]).

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

了解我们的 CAPTCHA 处理流程

熟悉我们的 CAPTCHA 处理 方法及其用法。这有助于判断 CAPTCHA 挑战是否是问题根源。

使用国家/地区参数

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

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

使用设备类型参数

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

如果在尝试这些步骤后问题仍然存在，请将问题详情以及您已采取的步骤告知您的专属客户经理。

需要启用某项功能？

某些 Agent Browser 功能默认受限。要调整限制，请联系 Oxylabs 支持（在线聊天 或 电子邮件）或您的专属客户经理：

• 更多持久化配置文件 – 将账户默认的 5 个已保存配置文件上限提高。
• 更多持久化会话 – 将账户默认的 5 个并发持久化会话上限提高。
• 受限目标 – 通过 KYC 流程解锁更多目标类别。
• 更高的速率限制 – 提高到超过 100 个并发会话 / 每秒 10 个。