为什么 sitemap 里的 .html 链接打不开？站长必看的排查指南

站长在提交 sitemap 后最常遇到的困惑之一："sitemap.xml 里明明列出了链接，点开却全是 404 打不开。" 这一般不是程序问题，而是服务器伪静态 rewrite 配置的问题。这篇文章用 Clara BBS 的实际机制，把原因和排查步骤一次讲清。

结论先说：

**sitemap 里的 .html 链接打不开，99% 是服务器没有正确配置伪静态转发规则，与系统程序无关。**

一、先理解 .html 链接为什么能"存在"

Clara BBS 的链接形如 `thread-123.html`，但磁盘上并不存在这个文件。看 `app/Core/Router.php` 的源码：

/**
 * 前台路由
 * 说明：Router 会自动剥掉 URI 末尾的 .html 后缀，
 *       因此 /login 与 /login.html 等价，GET 与 POST 共用同一组规则。
 */
if ($path !== '/' && substr($path, -5) === '.html') {
    $path = substr($path, 0, -5);  // 剥掉 .html 后缀
}

它的工作链路是：

浏览器请求 thread-123.html
  → 服务器 rewrite 规则把请求转发给 index.php
  → Router 剥掉 .html 后缀 → 路由到 ThreadController → 动态渲染页面

如果服务器没有 rewrite 转发这一步，`thread-123.html` 就会被当成"不存在的静态文件"，直接返回 404——这就是链接打不开的根本原因。

二、三大常见原因

原因 1：Nginx 未配置 try_files / rewrite 规则

Nginx 默认不会把 `xxx.html` 转发给 `index.php`，需要显式配置：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

没有这行，所有 .html 伪静态链接全部 404。

原因 2：Apache 的 .htaccess 未生效

Clara 安装包自带 `.htaccess`（内含 RewriteRule），但 Apache 需要开启：

<Directory "/站点路径">
    AllowOverride All
</Directory>

如果 `AllowOverride` 是 `None`，`.htaccess` 会被完全忽略，rewrite 规则形同虚设。

原因 3：宝塔等面板站点未应用伪静态规则

宝塔面板默认站点是"无伪静态"状态，需要：站点设置 → 伪静态 → 选择对应规则（或填写上述 try_files）→ 保存。

三、30 秒自检法

直接访问你的域名首页，然后：

1. 访问 `https://你的域名/thread-1.html`
2. 正常显示帖子页 ✅ → rewrite 生效，问题出在别处
3. 返回 404 ❌ → 就是服务器伪静态配置问题

再对照检查 sitemap 地址本身：直接访问 `https://你的域名/sitemap.xml`，如果能打开 XML 而里面的链接 404，则问题 100% 锁定在 rewrite 配置。

四、正确排查顺序（照做即可）