上个月一个客户把跳转规则里某个分支的目标页面换掉,配置推送后刷新了缓存,结果前台返回的还是旧版本。他第一反应是缓存没清干净,反复刷了三轮,问题依旧。这类故障的成败取决于一个判断:你分不清"缓存里存的是旧页面"和"判定层根本没重新算",就会在错误的层反复折腾。跳转缓存刷新后旧版本仍返回,先做的不是清缓存,而是把缓存层与判定层拆开验证。
先分清两种"旧版本"的来源
同样是看到旧页面,成因完全不同。一种是缓存层确实存着旧内容,键没变、值没更新;另一种是缓存已经清空,但判定层读取的输入没变,重新算出来的还是旧结论。两者的排查入口差得很远。
判断方法很简单:临时把某条请求的缓存绕开,直接观察判定层输出。如果绕开缓存后返回新版本,问题在缓存层;如果绕开缓存后仍是旧版本,说明判定逻辑的输入或写入环节有问题。这一步不做,后面所有操作都是猜。
缓存层:键结构决定刷新是否真的生效
缓存刷新失效最常见的原因是键里带了不该带的字段,或者该带的版本字段没带。
- 键里包含目标页面地址的哈希:规则改了页面地址,键随之变化,旧键自然失效,这种情况反而不会出问题。
- 键里只包含访客标识、不含规则版本号:规则更新后键不变,旧值继续命中,刷新配置对缓存无效。
- 键里包含请求头里易变字段(如时间戳、随机数):缓存命中率极低,看起来"刷新立即生效",实际是缓存根本没起作用,掩盖了别的问题。
通用做法是在缓存键里显式加入规则库版本号,规则发布时版本号自增,旧键整体自然过期,不依赖手动清理。这一思路与跳转响应头缓存配置里讲的版本边界定法是一致的,只是作用位置从响应头挪到了键结构上。
还要注意多级缓存。Nginx 层、应用层、甚至 CDN 层各有一份,刷新命令只打到其中一层,其余层继续供旧值。排查时逐层绕开,确认每一层的行为,别把"清了一层"当成"清完了"。
判定层:写入时机比读取逻辑更容易出错
缓存绕开之后仍是旧版本,重点查判定结果的写入链路。常见情况是判定结果在请求早期就被写入,而规则版本号是在请求后期才读取,两次读取之间配置已更新,写进去的是旧规则算出的结论。
一个可操作的验证方式是比对同一访客的两次请求:第一次请求前后的规则版本号是否一致,判定结果落库时带的版本号与当前生效版本号是否一致。如果落库版本号落后于生效版本号,说明写入时机偏早。
另一个高频问题是判定结果缓存与页面内容缓存分开存储,更新时只失效了后者。表现是判定结果指向新版本,但页面内容仍是旧的。这类情况在斗篷系统缓存命中的排查路径里也有对应描述,核心都是先确认"哪一层在供旧值"。
回源路径:绕开缓存不等于绕开旧逻辑
有些团队为了验证,直接把请求打到后端源站,以为绕开了所有缓存。但如果源站前面还有一层反向代理在做版本改写,或者源站自身读的是本地配置文件而配置尚未重载,请求依然会拿到旧结果。
验证回源时要确认三件事:请求确实打到了预期节点、该节点加载的配置版本是最新的、节点上没有本地结果缓存。三者缺一,"回源验证"就是无效验证。必要时在响应头里带上节点标识与配置版本号,让每次验证都有据可查。
一个匿名复盘
某团队做教育投放,日均点击一千二三,服务器两台中等规格。一次规则调整后,部分流量持续返回旧页面,持续了大半天。他们先清了 Nginx 缓存,无效;又重启了应用进程,仍无效。后来按上面的顺序拆:绕开缓存直连应用,返回新版本,说明缓存层有问题;再看键结构,键里没有规则版本号,规则更新后旧键继续命中。加上版本号字段后重新发布,旧键自然过期,问题消失。整个过程真正的修复动作只有一处,前面两轮操作都是因为没先分层。
小结
跳转缓存刷新后旧版本仍返回,处理顺序应当是先绕开缓存看判定层,再查键结构,最后验证回源路径是否真的绕开了旧逻辑。三层里任何一层没确认,后面的操作都可能白做。规则版本号进缓存键、判定结果落库带版本标记、回源响应带节点与版本标识,这三项做扎实,同类问题基本能在十分钟内定位到层。
常见问题
跳转规则改了,缓存也清了,为什么用户看到的还是旧页面?
这个要看情况。先确认清的是哪一层缓存,多级缓存只清一层很常见。另外让用户强制刷新一次,如果强刷后是新版本,大概率是浏览器或中间层缓存,跟服务端判定无关。
缓存键里加规则版本号会不会让命中率变低?
会有一点影响,但只在规则发布那一刻集中过期,平时命中率不受影响。相比手动清缓存漏层带来的排查成本,这点代价很划算。顺带说一句,版本号建议用自增整数,别用时间戳,时间戳粒度太细容易把键打散。
判定结果写入数据库后,页面版本还会漂移吗?
会。写入只是第一步,读取时如果拿的是旧快照或者读到了另一个节点的本地缓存,照样漂移。关键是让写入和读取都带上同一个版本标记,对不上就回源重算。
回源验证时怎么确认请求真的绕开了缓存?
看响应头里有没有节点标识和配置版本号,没有就加一个。另外可以在源站临时打一条日志,确认请求到达时间与验证时间对得上。两样都对上,这次回源才算数。
延伸阅读
缓存分层定位清楚之后,下一步常遇到的是日志侧的证据不足,这篇讲日志分级采集范围与告警阈值的划定方法,能补上排查时"拿什么证明"这一环:日志分级采集与告警阈值划定