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