这是一个示例场景复盘:sitemap 文件在仓库中使用占位符并不一定是错误,但线上响应必须替换为真实域名。排查时要同时看仓库模板、服务端渲染和线上返回内容。
背景与目标
本文为示例场景,不代表 Google 官方反馈或真实客户案例。场景目标是检查站点提交前的 sitemap 是否输出真实域名,避免把模板占位符暴露给搜索引擎。
仓库中的 sitemap 可以保留 https://toolsbar.cn 这类占位符,但服务端或部署流程需要在实际响应时替换为 https://toolsbar.cn。
初始现象
检查时发现仓库文件中存在 SITE_ORIGIN,占位符本身不能直接判断为线上失败。真正需要确认的是访问 /sitemap.xml 时,响应内容中的 loc 是否已经变成真实 URL。
如果 robots.txt 指向旧域名、测试域名或占位符,也会影响后续提交和排查。
排查过程
第一步读取 public/sitemap.xml,确认它是模板还是最终产物。第二步请求线上 /sitemap.xml,看响应中是否仍有占位符。第三步请求 /robots.txt,确认 Sitemap 行是否指向同一个正式域名。
如果线上仍是占位符,应检查服务端替换逻辑、环境变量 SITE_ORIGIN、部署缓存和静态文件发布顺序。
修复与验证
修复动作通常不是手工把每个 URL 写死,而是保证生成或响应阶段统一替换域名。这样本地、测试和正式环境可以使用不同 origin,线上又能返回真实地址。
验证时应记录状态码、响应中的首个 loc、是否存在占位符、robots.txt 中的 Sitemap 行,以及 sitemap URL 数量是否与公开路由一致。
经验总结
技术基线检查要区分仓库模板状态和线上响应状态。仓库中出现占位符不一定错误,线上提交给搜索引擎的响应仍有占位符才是明确问题。
类似检查也适用于 canonical、Open Graph URL 和结构化数据中的 mainEntityOfPage。
立即处理
使用相关工具
常见问题
关于这个问题
仓库 sitemap 有占位符是否一定错误?
不一定。若服务端或部署流程会在响应时替换为真实域名,仓库模板保留占位符是可以接受的。
sitemap 修好是否代表 AdSense 一定通过?
不能。sitemap 属于技术基础项,AdSense 内容价值仍取决于页面内容质量、原创性、可用性和整体站点信任度。
