> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/cn/headless-browser/troubleshooting-guide.md).

# 故障排查指南

| 症状                                        | 可能原因                            | 解决方案                                                            |
| ----------------------------------------- | ------------------------------- | --------------------------------------------------------------- |
| *401 无效凭据（凭据是正确的）*                        | 使用 `ws://` 协议                   | 切换为 `wss://`                                                    |
| *401 无效凭据*                                | 仅有 `用户名` 不带后缀                   | 使用仪表板中的后缀标记和完整用户名（例如， `_ab12`)                                  |
| *CDP\_SESSION\_RATE\_LIMIT\_REACHED*      | 您尝试每秒启动过多浏览器                    | 保持在 `10` 每秒会话数限制内，或 [联系支持](#need-a-feature-enabled-1) 以提高上限。    |
| *CDP\_MAX\_CONCURRENT\_SESSIONS\_REACHED* | 您的活动会话数量已达到限制                   | 保持低于 `100` 并发会话总数，或 [联系支持](#need-a-feature-enabled-1) 以提高上限。    |
| *会话检查（VNC）无法连接（浏览器已启动）*                   | 已达到 VNC 最大限制                    | 使用更少的 VNC 会话。                                                   |
| *TLS / 证书错误*                              | Node.js 中的证书验证                  | 设置 `NODE_TLS_REJECT_UNAUTHORIZED="0"` 在引入 Playwright 之前（仅用于测试）。 |
| *CDP\_LIMIT\_REACHED: 已达到配置文件限制*          | `o_profile` 数量超过 `max_profiles` | 重用一个稳定的配置文件名称，或联系支持以提高上限。                                       |
| *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。                                               |

{% hint style="info" %}
仍然卡住？通过在线聊天或电子邮件联系 Oxylabs 支持（<support@oxylabs.io>).
{% endhint %}

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

### **了解我们的 CAPTCHA 处理流程**

熟悉我们的 [CAPTCHA 处理](broken://pages/f01a0d8a239351a0ac1cd6dca07879ea93bf8dcb) 方法及其用法。这可以帮助判断 CAPTCHA 挑战是否是问题根源。&#x20;

### **使用国家参数**

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

您可以通过添加以下内容为浏览器会话指定国家/地区： `?p_cc`  参数到您的连接 URL。更多信息可见于 [地理位置定位](broken://pages/4b1a86696a546bfed0b14c7d0d203ec7821d16f1).

### **使用设备类型参数**&#x20;

尝试使用设备参数可以提高成功率。您可以通过使用以下参数自定义浏览器模拟不同设备类型的方式： `?p_device` 参数。更多信息可见于 [设备类型](https://developers.oxylabs.io/scraping-solutions/unblocking-browser/chrome#device-type) 部分。

{% hint style="info" %}
如果尝试这些步骤后问题仍然存在，请将问题详情和您已采取的步骤告知您的专属客户经理。
{% endhint %}

## 需要启用某个功能吗？ <a href="#need-a-feature-enabled" id="need-a-feature-enabled"></a>

某些 无头浏览器 功能默认关闭或受限。要访问这些功能，请联系 Oxylabs 支持（[在线聊天](https://oxylabs.io/) 或 [电子邮件](mailto:support@oxylabs.io)）或您的专属客户经理：

* **持久化配置文件** — 提高 `max_profiles` 上限。
* **受限目标** — 通过 KYC 流程解锁更多目标类别。
* **更高的速率限制** — 提高到超过 `100` 并发会话 / `10` 每秒。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/cn/headless-browser/troubleshooting-guide.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.