一、现象:数据库里明明改好了,前台纹丝不动
2026-11-05,本站刚把数据层从 MySQL 容器换成 SQLite 单文件(那天的完整决策与实测见《MySQL 到 SQLite 的不停机迁移实录》)。迁移收尾时要修一批正文里的旧内链,我图快,直接在库上跑了裸 SQL(raw SQL)——不经过 WordPress,UPDATE 直接改 wp_posts:
# 宿主机上;迁移后数据层是 SQLite 单文件
sqlite3 /opt/blog/wp.db "UPDATE wp_posts SET post_content = replace(post_content, '/2025/03/01/old-slug/', '/2026/03/01/new-slug/') WHERE ID = 119;"
1. 先确认库里真的改到了,再谈别的
sqlite3 /opt/blog/wp.db "SELECT count(*) FROM wp_posts WHERE post_content LIKE '%new-slug%';"
1. 1 ← 数据是新的
SELECT 返回 1,库里没问题。打开前台那篇文章:旧链接,还在。强刷、换浏览器、换手机流量:还在。到这一步影响面很清楚——不是某台设备的缓存,是服务端在往外发旧内容。
反模式一:遇到”改了不生效”先重启。这个站的请求路径上叠着三层缓存,重启只能碰运气撞掉其中一两层,撞不掉的照旧。正确姿势是先画地图,再逐层走。
二、先看地图:三层缓存各管一段
| 层 | 组件 | 后端 | 缓存的是什么 | 对应失效命令 |
|---|---|---|---|---|
| 对象缓存 | redis-cache 插件 | redis db1 | WP 内部键值(option、查询结果对象等) | wp cache flush |
| 数据库缓存 | W3TC dbcache | redis db1 | SQL 查询结果集 | wp w3-total-cache flush all |
| 页面缓存 | W3TC page cache(file_generic) | 磁盘文件 | 整页 HTML(含带查询串的 URL) | 同上,或删缓存目录 |
这张表是排查前必须有的东西。关键认知:裸 SQL 三层全不感知。UPDATE 不经过 WordPress,WP 没机会按内容依赖去失效任何一层;对象缓存和 dbcache 里的旧查询结果继续命中,页面缓存继续把旧 HTML 原样吐出去。逐层清,一层清完确认一层。
三、第一层:对象缓存,一条 flush 引发的误判
第一反应是清对象缓存:
# 博客服务器上,WP 安装目录内执行
wp cache flush
1. Success: The object cache was flushed.
回前台看:没变。我的第一个误判在这里——以为这条命令没生效。实际上它大概率清对了东西,只是另外两层还压在上面。反模式二:拿”前台没变”反推”命令无效”。三层缓存的世界里,一条 flush 只清一层,这个反推是这场排查里所有弯路的共同起点。
不放心,直接上 redis 验证。第二个坑马上出现:
# 宿主机;看看对象缓存所在的 db1 有多少键
redis-cli -h 127.0.0.1 -p 6379 -n 1 DBSIZE
1. (error) NOAUTH Authentication required.
这台 redis 设了密码。NOAUTH 报错如果不细看,很容易误判成”端口不对/没有这个库”,然后跑去查端口查容器。正确的下一步是带密码进来,先看键数再决定清不清:
# 带密码进入;密码放环境变量,别写进命令行历史
redis-cli -h 127.0.0.1 -a "$REDIS_PASSWORD" -n 1 DBSIZE
1. (integer) 0 ← 奇怪,本栈 redis 的 db1 是空的
db1 是空的——WordPress 根本没在用这个 redis。第三个坑:我默认”博客的 redis 就是本栈起的那个”。看配置,别猜:
# WP 到底连的哪个 redis,wp-config 里写着
grep -n "REDIS_" wp-config.php
1. define( 'REDIS_HOST', 'draftdesk-redis' ); ← 热榜聚合栈的 redis 容器,不是本栈的 127.0.0.1
对象缓存和 dbcache 的后端,是另一套 compose 栈(draftdesk)里的 redis 容器,W3TC 和 redis-cache 共用它的 db1。之前的每一次”清缓存”,清的都是一个 WP 根本不看的实例。对准正确的实例再来一遍:
# 目标改成 WP 实际连接的那个实例
redis-cli -h draftdesk-redis -a "$REDIS_PASSWORD" -n 1 DBSIZE
1. (integer) 412 ← 这次对了
redis-cli -h draftdesk-redis -a "$REDIS_PASSWORD" -n 1 FLUSHDB
这一层的常见根因收进表里。对象缓存这层确认清干净了,往下走。
| 根因 | 特征 | 验证 |
|---|---|---|
| 清了不是 WP 在用的实例 | flush 成功但前台无变化,目标实例键数很少或为 0 | grep "REDIS_" wp-config.php 对 host |
| redis 有密码,命令被拒 | NOAUTH 报错 |
带 -a 重试,报错消失 |
| 只清了这层就下结论 | flush 后前台仍旧,误判命令无效 | 记住三层各自独立,继续下一层 |
四、第二层:dbcache,绕过 WP 的 SQL 它永远不感知
dbcache 缓存的是 SQL 查询结果。它的失效靠 WordPress 在写操作后主动丢弃相关 key——而裸 SQL 恰恰绕过了这整套通知机制,所以旧查询结果会一直命中到过期为止。清它用 W3TC 自己的命令:
# WP 安装目录内;flush all 覆盖 dbcache、页面缓存等全部 W3TC 模块
wp w3-total-cache flush all
这一层没有单独骗到我,但它解释了”为什么之前在后台改文章有时也要等一会儿才生效”——历史遗留的小怪味,这次一并想通了。dbcache 正常就往下走,真正的大 boss 在第三层。
五、第三层:页面缓存,以及骗过我的 REST
页面缓存用的 file_generic(磁盘增强模式),整页 HTML 落在 wp-content/cache/page_enhanced/ 下面。上面的 flush all 理论上已经清了它,验证一下目录,然后做了一件后来看是自欺欺人的事——用 REST 验证数据:
# 确认页面缓存目录确实空了
ls wp-content/cache/page_enhanced/
1. (空)
1. 用 REST 看这篇的修改时间——这是错的验证方式,原因见下
curl -s "https://blog.x-rush.cn/wp-json/wp/v2/posts/119?_fields=id,modified"
REST 返回的 modified 还是旧时间,我据此怀疑”库里压根没改成”,又回库里 SELECT 了一圈——当然还是新的。卡了十分钟后才想到去核对响应本身:这个带查询串的 REST URL,被 file_generic 当成普通页面整页缓存了。我看到的不是 WordPress 的实时应答,是一份缓存页快照。用缓存里的数据验证缓存外的问题,结论必然是错的。
正确的验证姿势是看前台 HTML,并且加随机查询参数绕开页面缓存:
# 随机参数让 URL 不命中任何已缓存的页面
curl -s "https://blog.x-rush.cn/2026/03/01/that-post/?bust=$(date +%s)" | grep -c "new-slug"
1. 1 ← 数据其实早就通了
| 验证方式 | 本例中的结果 | 为什么可信/不可信 |
|---|---|---|
| REST API(带查询串) | 返回旧数据,误导排查 | URL 被 file_generic 整页缓存,看到的是快照 |
| 前台 HTML + 随机参数 | 返回新数据 | 随机参数绕开页面缓存,打到真实渲染路径 |
| 直接查库 | 返回新数据 | 可信,但只证明”库对了”,不证明”链路通了” |
到这里,三层缓存都清干净了,数据用正门(WP 后台重新保存那篇文章,让 WP 自己走失效流程)又改了一遍。按理说该结束了——但还有个别页面在吐旧内容。
六、隐藏 BOSS:Apache 老 worker 握着旧配置
缓存全清、内容全对,仍有零星页面是旧的。这时候怀疑对象只剩 Web 服务器本身。这个站的 WordPress 由宿主机 Apache 直接服务,排查当天早些时候改过一轮缓存相关配置,之后做的是 reload。看 worker 的出生时间:
# 宿主机;重点看每个 worker 的启动时间
ps -o pid,lstart,etime,cmd -C apache2
1. PID STARTED ELAPSED CMD
1. 812 Tue Oct 28 09:14:00 8-03:21 /usr/sbin/apache2 -k start ← 改配置之前就在
1. 9907 Wed Nov 5 16:40:00 00:12:03 /usr/sbin/apache2 -k start ← 新生代
根因落地:Apache 的优雅重载(reload,SIGUSR1)不会杀掉在役 worker。老 worker 会带着 reload 之前加载的旧配置继续服务,直到手头连接结束才退场;KeepAlive 长连接加上小站的低流量,让它们可以存活非常久。对这批 worker 来说,”改配置 + 清缓存”从未发生过,它们按旧规则继续读旧的缓存。处理很简单:
# 让所有 worker 换代,新配置才算数
systemctl restart apache2
重启后全部页面回归一致。整场排查从”改了不生效”到收尾,四个隐藏点全部踩完:REST 也被缓存、redis 有密码、用了别栈的 redis、Apache 老 worker——没有一个是”原因清单”里能一眼看到的。
七、根因清单:按踩中概率排序
| 排序 | 根因 | 一行验证 |
|---|---|---|
| 1 | 三层只清了一层就下结论 | 对照第二节地图,逐层清、逐层验 |
| 2 | 清错了 redis 实例(WP 连的是别的栈) | grep "REDIS_" wp-config.php 对 host |
| 3 | NOAUTH 误读为”服务不存在” | 带 -a 重试一次 |
| 4 | 用带查询串的 REST 验证,看到的也是缓存 | 改用前台 HTML + 随机参数 |
| 5 | reload 后老 worker 握旧配置继续服务 | ps -o lstart -C apache2 看出生时间,必要时 restart |
八、之后立的规矩
| 场景 | 规矩 | 一句话为什么 |
|---|---|---|
| 改内容 | 走 WP API 或后台编辑器,杜绝裸 SQL 改生产库 | WP 才会按依赖失效三层缓存 |
| 验证改动 | 看前台 HTML 加随机参数,不看 REST | REST URL 也在页面缓存射程内 |
| 改缓存/服务配置 | reload 之后必看 worker 世代 | reload 不等价于配置生效 |
| 排查前 | 先写清依赖拓扑:谁连哪个 redis、哪个 db | 本例最贵的时间花在清错实例上 |
| 清缓存 | 三条命令打包执行再验证 | wp cache flush + w3tc flush all + 目标 redis FLUSHDB |
可自动化的部分:把”改完前台是否更新”做进发布后的检查(curl 前端加随机参数比对关键词),失败即报警——比任何”感觉没变”都快。
九、这次排查教会了什么
- 三层缓存之下,裸 SQL 改库等于对空气说话——不是改错,是三层全都不感知,前台永远给你旧世界
- flush 之后”前台没变”不能反推”命令无效”,先确认自己清的是不是同一个实例(redis 有密码、别栈实例、库编号,三关逐个过)
- 验证渠道本身可能被缓存:带查询串的 REST URL 会被 file_generic 整页缓存,验证一律看前台 HTML 加随机参数
- reload 只是请求,不是事实;Apache 老 worker 会握着旧配置活很久,改完配置看
ps lstart再收工 - 排查的顺序价值大于答案清单——这套”地图 → 逐层 → 每层验根因 → 隐藏点”的走法,和《Nginx 502 与 504 的分层排查》、《Docker 容器无限重启的排查路径》是同一件事:先画路径,再谈病因
本文记录的是 2026-11-05 本站真实事件,命令与输出均为当时实录(主机名、路径已脱敏)。全文未引用软件版本号,命令语义在 W3TC + redis + Apache 组合下当日实测;环境不同(比如页面缓存换成了 Nginx fastcgi_cache)结论会不同,但”先画缓存地图、逐层验证、警惕验证渠道本身被缓存”这个框架是通用的。