> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/room-will-not-connect.md).

# 房间无法连接

修复聊天体验房间仍在加入角色、体验无法打开，或选择器无法解析某个角色 ID 的问题。

聊天体验房间会以空房间打开，并在你放入第一批角色的那一刻连接起来。如果没有发生这种情况，房间会在消息框、角色选择器或本应承载该体验的页面上提示你。使用此页面查看这些消息并让房间运行起来。

### 角色仍在加入

加入需要几秒钟，房间会在此期间显示这一点。

你选择的每个角色都会在……中占据一行 [侧边栏](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/room-controls-reference.md) 会立即显示 **正在加入房间……** 在其名称下方，消息框会被锁定并显示 **等待角色加入……**。成员列表控件在同一时间段内也会冻结，并显示 **正在连接房间……** 作为原因，显示在……下方 **添加角色**.

这三项都会自行解除：各行恢复为普通行，线程会添加一条分隔线，写上角色名称并说明它们已加入且已被简要说明，消息框则会接收你的第一条消息。

如果房间未能启动，消息框会变为 **房间无法连接。请重新选择角色以重试。**，加入中的行消失，房间会显示一条带有原因的通知。记下它说了什么，然后继续下一节。

### 房间无法连接

消息框显示 **房间无法连接。请重新选择角色以重试。** 当房间未打开时。没有放入任何角色，没有任何发言，也没有记录任何会话。

{% stepper %}
{% step %}

#### 再次打开角色选择器

房间是空的，因此 **添加角色** 会像在任何空房间里那样出现在……上 **添加参与者** 卡片位于侧边栏中，并在……下方 **房间里还没有任何人** 在线程中。两者任意一个都会打开 **将角色添加到房间**.
{% endstep %}

{% step %}

#### 选择角色并确认

再次选择与之前相同的角色并确认。选择器会像第一次一样在同样的两个标签页中工作。请参见 [将角色添加到房间](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/add-characters-to-the-room.md) 了解通过它的任一路径。

这些行会显示 **正在加入房间……** 再次出现，消息框会恢复为 **等待角色加入……**.
{% endstep %}

{% step %}

#### 检查房间是否已启动

各行稳定下来，线程会标明角色已加入并已简要说明，消息框会解锁并显示输入提示。重试会开启一段全新的对话，因此提示词就是房间在发送第一条消息前显示的那个： **询问群组……**，或 **Message** 在只有一个角色的房间中后面跟着角色的名字。你向房间发言后，提示词会改变，且 [发送你的第一条消息](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/send-your-first-message.md) 涵盖它的各种形式。
{% endstep %}
{% endstepper %}

### 体验无法打开

无法打开的体验会在房间或列表位置显示这一点，而这些状态各自都有自己的返回方式：

| 你看到的内容                                           | 含义                                  | 执行什么                                               |
| ------------------------------------------------ | ----------------------------------- | -------------------------------------------------- |
| 一个标题为……的面板 **无法加载此聊天体验**，并带有一个 **返回我的体验** 按钮在其下方 | 面板会直接说明这两种可能性：“它可能已被删除，或者无法连接到服务器。” | 选择 **返回我的体验** 并从列表中重新打开该体验。若列表已成功加载但该体验仍然缺失，则它已被删除 |
| 在……上显示“无法加载聊天体验。” **我的体验**，并将 **重试** 在其旁边        | 列表完全没有加载，因此无法从中打开任何内容               | 选择 **重试**。列表会填入你的体验，消息会变为                          |
| 显示“无法加载聊天体验。当前显示的内容可能不完整。”并带有 **重试**             | 部分列表已加载，因此你的某个体验可能不会出现在当前显示内容中      | 选择 **重试** 在你认定某个体验确实不在列表中之前                        |

### 无法添加角色

你在……下查找的角色 **按角色 ID** 会变成……下方的一行 **结果**，而未解析成功的行会说明发生了以下三种情况中的哪一种：

| 该行显示                    | 含义                                          | 执行什么                      |
| ----------------------- | ------------------------------------------- | ------------------------- |
| **无权访问** 后跟 ID 的缩写形式    | “此角色存在，但尚未与你共享。请让其所有者与你共享，或将其设为公开。”         | 请让该角色的所有者与你共享，然后再次按 ID 查找 |
| **没有 ID 为** 后跟 ID 的缩写形式 | “你无法访问此 ID 对应的角色。请检查是否有拼写错误，或请分享者将该角色与你共享。” | 将该 ID 与你收到的那个进行核对，然后再次查找  |
| **无法查找** 后跟 ID 的缩写形式    | “查找此角色时出了点问题。请重试。”                          | 再次选择查找按钮                  |

当该行带着角色名称、描述以及一个……重新出现时，这三种情况中的任一种都已解决。 **添加** 按钮。

开启 **来自我的工作区**，匹配不到任何内容的搜索会显示“没有匹配的角色。”清空搜索字段可恢复网格；如果你想要的角色不在最近编辑的八个之内，请使用网格下方的按钮展开它。如果搜索字段已经为空，则该标签页根本没有可提供的角色，因此请在……下查找该角色 **按角色 ID** 替代。

### 仍被阻止

如果房间再次以相同通知失败，或者列表在……之后仍然无法加载 **重试**，请联系 <support@convai.com>。请写明你当时正在打开的聊天体验名称，并逐字引用该通知。

### 相关页面

这些页面会回答本页面未涵盖的聊天体验症状。

{% content-ref url="/pages/7cc57a2b494366f09283fa8158dccdad2665c0c2" %}
[无法发送消息](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/composer-is-locked.md)
{% endcontent-ref %}

{% content-ref url="/pages/bd8ecd0a747fe5a0b24502f315519d2b336ad2d9" %}
[简报与文字记录](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/briefs-and-transcripts.md)
{% endcontent-ref %}

{% content-ref url="/pages/e66e9e0ec4110edb5e946c0e1dc157bf6fcf6b0a" %}
[向房间添加角色](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/add-characters-to-the-room.md)
{% endcontent-ref %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/room-will-not-connect.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.