侧边栏壁纸
博主头像
一笑痕

人生若只如初见,
是可喜亦或者是可悲?

  • 累计撰写 291 篇文章
  • 累计收到 7 条评论

304 的错误确认出在日期条件先被判断

2026-11-20 / 0 评论 / 10 阅读

304 的错误确认出在日期条件先被判断

缓存命中率看着正常,页面却偶尔拿到旧内容,检查请求头时发现它带着两个条件: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 使用。静态服务通常会代劳,自己实现响应逻辑时则应把冲突条件放进测试。日期可以作为兼容的后备,不能推翻明确的实体标签结果。

    🤞 分享