Ethan Zhu成都

项目 · 工作记录

WordPress / Martech 排障与程序化改站

维护中 · 2026— · 实施 + 排障
WordPress · REST API · PHP 插件 · GTM · GA4 · 浏览器自动化

把「后台显示已保存但线上不对」这类隐性故障,变成可复现、可停止、可验证的检查流程,并用自建插件让 Agent 能安全地程序化改站。

01 / 问题

Martech 的故障通常没有报错。文章发布了但 SEO 字段没同步;Schema 在后台存在却和模板重复输出;GTM 工作区改对了但没发布;sitemap 停在上个月。

如果 Agent 只相信界面上的「已保存」,它会非常稳定地制造假完成。

02 / 系统

案例:文章发布后 sitemap 不更新。 这是一次完整的四段式排障:

阶段内容
症状通过 REST 发布的文章,线上 sitemap 长时间不出现,站长工具也抓不到;后台手动保存一次却会立刻正常。
追踪顺着「谁负责重建 sitemap」查:SEO 插件的缓存重建只挂在后台保存动作和 cron 上,REST 发文这条路径根本不经过那两个钩子,所以缓存永远是旧的。
修复自写一个小插件,在 REST 发文完成后主动触发 sitemap 重建,并校验新 slug 确实进入了索引文件。
验证发一篇测试文 → 拉取线上 sitemap 核对 slug 与 lastmod → 站长工具复查。之后沉淀成发布后的固定检查项。

修复插件的核心就是补上那个从来没被触发的钩子,并且当场回读验证:

// 根因:SEO 插件的 sitemap 缓存监听只在后台 / cron 上下文挂载,
// 通过 REST 发文不会触发失效。修复:REST 写入后主动重建并校验。
add_action('rest_after_insert_post', function ($post) {
    if ($post->post_status !== 'publish') return;
    do_action('my_rebuild_sitemap');           // 调用插件的重建入口
    my_verify_slug_in_sitemap($post->post_name); // 立刻回读 sitemap,找不到就记日志并告警
}, 10, 1);

简化示意,字段与真实协议一致,已去掉品牌与内部路径。

REST 桥接插件。 为了让 Agent 能改站又不误触,我把需要程序化操作的东西做成显式接口:SEO 标题 / 描述 / canonical 等字段、301 跳转规则、多语言镜像文案的写入与读取。这样改站动作是幂等的、可 diff 的、可回滚的,也不需要让自动化去点后台的按钮。

「UI 显示已保存 ≠ 真的对」的四层交叉验证:

  1. API 层

    直接读回写入的字段,确认存的是我以为的值,而不是被另一个插件覆盖后的值。

  2. 页面源码层

    抓线上 HTML,确认模板真的输出了它,并且没有重复输出两份 Schema 或两个 canonical。

  3. 第三方检测层

    用结构化数据校验与站长工具确认外部解析结果,而不是自己看自己。

  4. 事件回传层

    对邮件、电话、消息类点击事件,做一次真实点击,确认数据落到分析后台。

浏览器自动化没有「看到按钮就点」的授权。遇到未发布的工作区变更、来源不明的配置、或者可能影响线上数据的状态,流程必须停下,把决定交回给人。

03 / 我的角色

我负责把模糊的「SEO 好像不对」「数据怎么没进来」,拆成能逐层验证的系统状态:hook、字段同步、模板、缓存、标签、事件链。然后把一次排障沉淀成后续 Agent 可以直接复用的检查清单,而不是每次重新猜。

04 / 结果

实际修复过标题层级、SEO 标题截断、sitemap 新鲜度、重复 Schema 等问题,也完成过多类联系方式点击事件的跟踪配置。自建插件通道让批量页面改动可以程序化进行,这是产品上架流水线能跑起来的前提。

公开版本不展示域名、后台截图或账户数据。

05 / 证据