> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/bang-zhu/troubleshooting.md).

# 故障排除

解决 GitBook 应用中的加载、连接和缓存问题

#### 页面或集成无法加载

如果 GitBook 应用无法加载、在某些页面上崩溃、显示“无法加载集成”，或者分析仪表板一直为空，通常是因为广告拦截器或隐私扩展屏蔽了应用的部分内容。

1. 暂时停用广告拦截器或隐私扩展，然后重新加载页面。
2. 如果你不想完全停用它，请将以下 [允许的域名](#allowed-domains) 添加到扩展程序的允许列表中。
3. 刷新页面，检查是否已正确加载。

#### “连接已断开”

“连接已断开”表示 GitBook 无法建立所需的网络连接，通常是因为你的电脑或网络中的某些设置阻止了连接。常见原因包括浏览器扩展、防火墙、安全软件、代理以及临时网络问题。

按以下顺序逐一尝试：

1. **清除缓存并重启浏览器。** 这可以解决大多数临时连接问题。
2. **重启 Wi-Fi 或以太网连接**，然后重试。
3. **尝试使用其他浏览器或设备。** 如果 GitBook 在其他环境中可以正常使用，问题可能出在你原先的设置上——联系支持团队时，请说明你使用的浏览器。
4. **逐一停用浏览器扩展** 以找出问题原因。
5. **检查防火墙或安全软件，确认其设置** 符合 [允许的域名](#allowed-domains).

另外，请查看 [GitBook 状态页面](https://www.gitbookstatus.com/) ，确认目前是否存在服务中断。

#### 强制刷新浏览器

支持团队可能会要求你 *强制* 刷新浏览器。这与普通刷新不同——它会清除页面仍在使用的缓存文件。

{% tabs %}
{% tab title="Chrome、Firefox 和 Edge" %}
在 **Windows**上，按住 CTRL 键并按 F5。在 **Mac**上，按住 CMD 和 SHIFT 键并按 R。
{% endtab %}

{% tab title="Safari" %}
首先清空缓存：按住 OPT 和 CMD 键并按 E。然后刷新当前页面：按住 CMD 键并按 R。
{% endtab %}
{% endtabs %}

#### 允许的域名

如果防火墙、代理或安全应用阻止了流量，请将以下域名添加到允许列表中。

**必需。** 缺少以下域名，GitBook 将无法正常工作：

* `*.gitbook.com` ——包括 `app.gitbook.com`, `api.gitbook.com`和 `files.gitbook.com`
* `*.gitbook.io`
* `*.googleapis.com` ——包括 `firebase.googleapis.com`, `firestore.googleapis.com`，以及 `www.googleapis.com`
* `*.googleusercontent.com`
* `cdn.iframe.ly` — 嵌入内容所需

**可选。** 这些域名用于分析和错误监控。屏蔽它们不会影响 GitBook 的运行：

* `segment-cdn.gitbook.com` 和 `segment-api.gitbook.com`
* `clearbit-risk.gitbook.com`
* `*.googletagmanager.com`
* `*.sentry.io`

如果完成以上所有步骤后问题仍然存在，请联系支持团队，并提供有关浏览器、设备和网络设置的详细信息。


---

# 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://gitbook.com/docs/documentation/zh/bang-zhu/troubleshooting.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.
