> 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/analytics/broken-links.md).

# 失效链接

查找你已发布网站上返回 404 的 URL，并使用建议的重定向加以修复

{% hint style="info" %}
失效链接处于测试版，并可在 Ultimate 站点方案中使用。
{% endhint %}

失效链接会找出访客正在访问但已不存在的你已发布站点上的 URL。对于每个失效 URL，GitBook 会判断访客最可能想查看的是哪一页，并建议一个你可以一键启用的重定向，这样访客就不会再落到 404 页面。

在站点侧边栏中，前往 **Improve → Broken links**.

## 工作原理

GitBook 会定期审计每个包含失效链接功能的方案中的已发布站点。每次审计都会执行以下步骤：

1. 检查站点过去 30 天的流量，并收集返回 404 的 URL。URL 至少被访问 3 次才会纳入统计；此外会忽略来自机器人和扫描器的噪声，例如对 `/wp-admin` 或 `.php` 文件的请求。
2. 合并相似的 URL，删除已被现有重定向覆盖的 URL，或因该路径下现在已有页面而再次解析成功的 URL，并按访问量对其余项排序。访问量最高的 60 个失效 URL 会继续处理。
3. 读取已发布的内容，找出每位访客最可能想访问的页面。如果整个版块都已迁移，GitBook 会将损坏的 URL 归为一条通配符建议，例如 `/v1/*`。如果没有匹配的页面，GitBook 会告知你，并在 30 天后再次检查该 URL。
4. 为每个有明确匹配的失效 URL 创建一个建议重定向，并附上简短说明，解释为何选择该页面，以及基于该 URL 所接收流量给出的严重程度。

一个站点最多每天审计一次。每次审计都会从你当前的流量重新开始，已解决的 URL 会被移除，因此如果一个站点有超过 60 个失效 URL，它们会在多次审计中逐步处理，先处理访问量最高的。GitBook 无法匹配到任何页面的失效 URL 也会保留为发现项，并附上原因和它考虑过的页面，这样你就可以判断它们是否需要新页面，而不是重定向。

Broken links 基于 [站点重定向](https://gitbook.com/docs/documentation/zh/publish/site-redirects.md)构建。如果你不熟悉重定向，请先阅读相关内容。

## 两种视图

失效链接有两种视图，你可以通过页眉中的选项卡在它们之间切换：

* **发现结果** 会列出 GitBook 找到的损坏 URL 及建议的重定向，供你审核。
* **分析** 会显示站点分析数据中的完整损坏 URL 报告，包括尚无建议的 URL。

## 审核发现项

“ **发现结果** ”视图首先会汇总过去 30 天的数据：

| 卡片         | 显示内容             |
| ---------- | ---------------- |
| **失效访问次数** | 你站点返回的 404 响应数量。 |
| **受影响访客**  | 访问到 404 的唯一访客数量。 |
| **建议重定向**  | 等待审核的未处理建议数量。    |

列表会显示每个发现项的状态、严重程度，以及描述失效 URL 的标题；如果 GitBook 找到了对应页面，也会显示它应跳转到的页面。带有建议修复方案的发现项会排在前面。

### 严重程度

严重程度反映了某个失效 URL 相对于你站点上其他失效 URL 所接收的流量。

严重程度分为三个级别：

* **高**：过去 30 天至少有 20 次访问，且属于站点访问量最高的五个损坏 URL 之一。
* **中**：流量稳定的 URL。
* **低**：过去 30 天仅被访问少数几次的 URL。

### 搜索、筛选和排序

在搜索框中输入 URL 或其部分内容，即可查找特定发现结果。使用筛选栏，按 **状态** 或 **严重程度**缩小发现结果范围。默认情况下，列表仅显示 **未处理** 的发现结果，并按严重程度排序。将排序方式切换为 **最近更新** ，即可优先查看最新更改。打开某条发现结果后再返回，搜索条件、筛选条件和排序方式都会保留。

## 修复失效 URL

1. 在列表中选择一个发现项即可打开其详情。
2. 阅读 **动机** 部分，了解 GitBook 将损坏 URL 与哪个页面匹配，以及匹配原因。 **相关页面** 列表提供了相关页面的链接。
3. 点击 **创建重定向**.
4. 后， **添加重定向** 对话框会打开，其中的 **源路径** 和 **目标** 已根据建议预先填写。你可以按需调整，例如，如果旧 URL 将不再恢复，请选择 **永久重定向** 。
5. 点击 **启用重定向** 以立即启用，或 **保存为草稿** 稍后可在站点的重定向设置中发布。

启用重定向后，如果其来源与某个未处理的问题相匹配，该问题会自动标记为 **已解决**。将重定向保存为草稿后，该问题会保持未处理状态，直到重定向正式生效。

重定向会添加到站点的重定向列表中。你可以随时通过 **设置 → 重定向**编辑或删除它，也可以点击屏幕顶部的 **管理重定向** 。

{% hint style="info" %}
创建重定向需要站点管理员权限，而更改发现项状态需要编辑权限。你无法使用的操作会显示为禁用状态，并附带说明。
{% endhint %}

### 通配符建议

当多个失效 URL 具有相同前缀，且都属于同一个迁移后的版块时，GitBook 会建议使用单个通配符重定向，例如 `/v1/*` 而不是为每个 URL 分别创建重定向。预填好的重定向对话框中已启用 **将通配符替换为匹配文本** ，因此 `/v1/installation` 会被发送到新目标下的匹配路径。请参阅，了解通配符重定向的行为。 [站点重定向](https://gitbook.com/docs/documentation/zh/publish/site-redirects.md) 关于通配符重定向的行为。

## 忽略某个发现项

如果建议不合适，或者失效 URL 不需要重定向，请打开该问题并点击 **忽略**。它会移至 **已拒绝** ，并从默认列表中消失。你可以通过筛选 **状态**再次找到它，并使用 **取消归档**.

你也可以使用状态菜单，直接从列表或详情页更改发现项状态：

| 状态      | 含义                      |
| ------- | ----------------------- |
| **打开**  | 该发现项正在等待审核。             |
| **已解决** | 已创建重定向，或者该 URL 已再次解析成功。 |
| **已拒绝** | 你选择忽略了该发现项。             |

当下一次审计发现该失效 URL 现在已能解析成功时，发现项也会自动解决，这可能是因为该路径下又有了页面，包括翻译页面，或者有一个现有重定向覆盖了它。

## 分析失效 URL

来恢复。 **分析** 视图会显示所选时间段内所有返回 404 的 URL，无论 GitBook 是否为其提供了建议。这些 URL 可能是拼写错误的 URL、没有重定向的过时链接，也可能是垃圾链接。你可以用它来查找需要新建页面而非重定向的失效 URL，或了解失效流量的来源。

报告包含以下卡片：

* **失效 URL 命中次数**, **受影响的访客**和 **不同 URL 数** 在所选时间段内的数据及其随时间变化的趋势。
* **热门失效 URL**按命中次数排序。
* **按维度查看失效 URL**可让你按以下维度对失效流量进行分组： **来源域名**, **失效 URL**, **完整来源网址**, **国家/地区**或 **设备**。按来源域名分组，是查找链接到过时 URL 的外部网站的最快方式，也有助于区分真正的过时链接和爬虫噪声。
* **自适应内容导致的 404**（如果你的站点使用了自适应内容）。这些访客访问了一个实际存在的页面，但因某项条件而无法查看。此类情况不会计入问题，因为重定向无法解决。

您可以使用与其他 [网站分析](https://gitbook.com/docs/documentation/zh/analytics/insights.md)相同的筛选条件来筛选报告，包括版块、语言、国家/地区、设备和引荐来源。


---

# 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/analytics/broken-links.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.
