> 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 应用无法加载、在某些页面崩溃、显示“我们无法加载该集成”，或者分析仪表板一直为空，通常原因是广告拦截器或隐私扩展程序阻止了应用的部分内容。

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.