笔记 ·
通过 REST 发文,sitemap 却不更新:一个缓存监听只挂在后台的根因
SEO 插件的 sitemap 缓存监听没挂在 REST 路径上,导致 API 发文永远读到旧缓存。
场景很简单:Agent 通过 WordPress REST API 批量发文,接口都返回成功。但过一阵子发现线上 sitemap 长时间不包含新文章,站长工具也迟迟抓不到新页面。
第一反应是怀疑 CDN 缓存,排查之后排除了,CDN 没有缓存这条 sitemap 请求。接着怀疑是 SEO 插件自己的 sitemap 缓存,顺着代码往下看,发现问题出在一个很具体的地方:SEO 插件(Rank Math)的 sitemap 缓存监听(Cache Watcher)只在后台 admin 上下文和 cron 里注册,REST 请求走的是完全不同的路径,根本没有挂载这个监听。也就是说,通过 REST 写入的文章,从来不会触发 sitemap 缓存失效,缓存会一直停在上一次后台保存时的状态。
这也解释了为什么问题一直没被发现:只要有人手动在后台点开文章再保存一次,sitemap 就会立刻正常,因为后台保存这条路径挂了监听。人工发文从来不会暴露这个问题,只有全自动、不经过后台界面的发布流程才会踩中。
修法是自己写一个很小的插件,钩住 rest_after_insert_{post_type} 这个动作,在文章状态变成已发布时,主动调用 SEO 插件自身的缓存重建入口,让它以为是一次正常的保存动作。光触发重建还不够,还要在发布脚本里加一步 --verify-slug:重建之后立刻回读线上 sitemap,检查新文章的 slug 是否真的出现在里面,如果没找到就让脚本失败退出,而不是默默地当作发布成功。这个校验步骤后来在两个站上都装上了。
这次排障留下的教训不是”sitemap 插件有 bug”,而是更基础的一条:接口返回成功、后台显示已保存,都不等于线上状态真的对。任何一个自动化写入动作,背后都应该有一个独立的读回校验去确认结果,而不是信任调用方自己给出的成功状态。这条后来变成了所有发布脚本的标准动作,不只是 sitemap 这一处:只要是写入类的自动化步骤,写完之后都要单独读一次线上真实状态,才算这次操作真正完成。