
缓存命中率看着正常,页面却偶尔拿到旧内容,检查请求头时发现它带着两个条件:If-None-Match 和 If-Modified-Since。如果服务端先检查日期,再检查 ETag,就可能对一个已经失效的实体标签回 304。客户端会把旧副本当成仍可复用,这个错很安静。
两个条件给出相反答案
If-None-Match 携带实体标签,If-Modified-Since 携带日期。单独看时,命中的条件都可能让 GET 得到 304。但它们并非可以任选一个判断。RFC 9110 要求只要请求带有 If-None-Match,接收方就忽略 If-Modified-Since。日期条件是旧式中间件兼容用的,精度也更低。
本机脚本把两个判断写成朴素版与按规范版,逐个发送条件请求。这里不是浏览器缓存的完整仿真,测试对象是 Node 的本机 HTTP 服务;对照重点是服务端如何解释已经收到的请求头。
案例 朴素实现 按规范实现
--------------------------------------------------------------------------
只有 If-None-Match,且命中 304 304
只有 If-None-Match,没命中 200 200
只有 If-Modified-Since,时间等于最后修改 304 304
只有 If-Modified-Since,时间早于最后修改 200 200
两个都带:ETag 没命中,IMS 说没改过 304 200
两个都带:ETag 命中,IMS 说改过了 304 304
两个都带:ETag 写成弱校验 W/"v1" 200 304
最容易误判的是表里的「ETag 没命中,IMS 说没改过」。朴素实现先看日期,返回 304;按规范实现看见 ETag 条件后,忽略日期,返回 200。客户端手里若只有旧版本缓存,304 就等于服务端认可了那份旧内容。规范版的 200 才会把当前正文送回去。
这类错误通常不会表现为解析失败,客户端拿到的是合法的 304,只是继续使用了过期表示。排查时应同时记录两个条件头和服务端状态码;只看缓存命中率或页面是否报错,都可能漏过这种错误确认。回归测试要保留一组冲突输入,才能锁定条件判断的先后顺序。
反过来,ETag 命中而日期说资源改过,两个实现都回 304。这次 304 只由 ETag 命中触发。把两种结果放在一起看,优先级比「哪个头比较新」清楚得多:先判断 If-None-Match;只有它没出现,才轮到 If-Modified-Since。
弱标签仍然要比较
表格还有一行把标签写成 W/"v1"。If-None-Match 使用弱比较,弱标签的前缀不妨碍它与同一不透明标签匹配。因此这个请求仍回 304,即使日期条件本来表示资源已更新。W/ 前缀不影响它参与 If-None-Match 判断;比较时不要求表示数据逐字节相同。
我会把验证器判断单独放在日期判断之前,不把两种条件拼成一个「任意命中就 304」的分支。测试至少要覆盖冲突输入:标签不命中而日期命中时,期待 200;标签命中、日期不命中时,期待 304。只测两个条件都给出同一答案,顺序写反也能过,测不出问题。
日期少了毫秒
没有 ETag 的资源还会碰到另一层限制。HTTP-date 只表示到秒,文件系统里的修改时间可以更细。脚本把资源修改时间设为 10:00:00.900,响应头只能写成 10:00:00 GMT。客户端带回这个时间时,服务端无法知道文件是在这一秒的哪个毫秒更新。
只给 Last-Modified 的资源(ETag 关掉),文件在 10:00:00.900 被改过
服务端回的 Last-Modified: Sun, 20 Sep 2026 10:00:00 GMT
客户端带 If-Modified-Since: Sun, 20 Sep 2026 09:59:00 GMT → 200
客户端带 If-Modified-Since: Sun, 20 Sep 2026 10:00:00 GMT → 304
客户端带 If-Modified-Since: Sun, 20 Sep 2026 10:00:00 GMT → 304
文件真实修改时间: 2026-09-20T10:00:00.900Z
Last-Modified 头能表达的精度: Sun, 20 Sep 2026 10:00:00 GMT (毫秒被截掉)
这组读数里,早一分钟的日期返回 200;精确到头部所能表达的 10:00:00 GMT 返回 304;文件实际修改时间仍是 10:00:00.900Z。Last-Modified 单独使用时,秒级精度可能把同一秒内的改动折叠掉。若资源更新频繁,ETag 能补上日期字段表达不了的版本差异;若只剩日期条件,304 的含义要按它的精度理解,不能当作毫秒级确认。
条件请求的实现顺序很短,却决定了缓存是否会被错误续用。If-None-Match 存在时,只按它做弱比较;没有它才检查合法的 If-Modified-Since,并且只对 GET 或 HEAD 使用。静态服务通常会代劳,自己实现响应逻辑时则应把冲突条件放进测试。日期可以作为兼容的后备,不能推翻明确的实体标签结果。