# PR #24935 完整报告

- 仓库：`sgl-project/sglang`
- 标题：:memo: docs: add canonical URL to fix Google indexing lmsysorg.mintlify.app instead of docs.sglang.io
- 合并时间：2026-05-15 07:46
- 原文链接：http://prhub.com.cn/sgl-project/sglang/pull/24935

---

## 执行摘要

在 `docs_new/docs.json` 中新增 `"canonical": "https://docs.sglang.io"` 配置，解决 Google 搜索结果误指向 `lmsysorg.mintlify.app` 的 SEO 问题。改动极小，无运行时风险。

## 功能与动机

Mintlify 托管文档时同时提供 `lmsysorg.mintlify.app` 和 `docs.sglang.io` 两个域名。由于没有设置 canonical 标签，Google 将旧子域名选为首要索引地址，导致用户搜索 "SGLang documentation" 时看到的是 mintlify 域名而非官方域名，影响品牌统一和流量归因。

## 实现拆解

1. **定位配置**：`docs_new/docs.json` 中的 `seo.metatags` 块。
2. **追加键值**：在原有 `google-site-verification` 之后添加 `"canonical": "https://docs.sglang.io"`（注意保留逗号分隔）。
3. **构建生效**：Mintlify 在生成 HTML 时会根据该配置自动插入 `<link rel="canonical" href="https://docs.sglang.io">`，指导搜索引擎将权重归一到 `docs.sglang.io`。

### `docs_new/docs.json`

唯一变更文件，在 SEO metatags 中添加 canonical URL 配置，修正 Google 索引。

```json
{
  "$schema": "https://mintlify.com/docs.json",
  "theme": "aspen",
  "name": "SGLang Documentation",
  "seo": {
    "metatags": {
      "google-site-verification": "bX3ofyYQhraIpAYf4DpyZQXZO_G4xLR_RqeBAKnJA7g",
      "canonical": "https://docs.sglang.io"  // 新增：指定权威域名，解决 Google 索引指向 mintlify 子域名的问题
    }
  },
  // ... redirects 等其他配置保持不变
}

```

## 评论区精华

无 reviewer 讨论。

## 风险与影响

- **风险**：极低。仅修改文档配置 JSON 文件，不影响任何运行时逻辑或 API 行为。错误的 canonical URL 可能导致 SEO 无效，但 CI 可验证。
- **影响**：正面。Google 搜索结果将统一指向 `docs.sglang.io`，提升品牌一致性；不影响现有文档内容或功能。

## 关联脉络

无关联 PR 或 Issue。这是一个独立的 SEO 修复，属于文档配置的常规优化。