Last-Modified 只到秒 文件改完浏览器仍用旧版 304 怎么补 ETag

运营改了主题色的一个变量,用户刷新页面还是旧颜色。F12 看 style.Css 返回 304,响应头里 Last-Modified 是 14:32:07,文件实际改动时间也是 14:32:07,同一秒。

静态文件由 nginx 直出,ETag 默认是开的,但这个站的 CSS 由 PHP 拼出来,走的另一条链路,只写了 Last-Modified,值取 date 到秒,精度不够区分同一秒内的两次改动。

第一反应是给所有资源加版本号参数。缓存问题没了,代价是每次发版全站缓存失效,回源带宽从 90Mbps 冲到 320Mbps,机器扛不住。

改成用文件内容算 ETag,强校验,和 Last-Modified 一起返回。浏览器优先用 ETag,秒级时间戳的精度问题就绕过去了。

$etag = '"' . md5_file($f) . '"';
header('ETag: ' . $etag);
if (trim($_SERVER['HTTP_IF_NONE_MATCH'] ?? '') === $etag) {
    http_response_code(304);
    exit;
}

还要处理两个条件头同时出现的情况。按 RFC 的优先级先比 ETag 再比时间,两个都带了但 ETag 不匹配,必须返回 200,不能因为时间没变就回 304。

上线第一天 304 占比 41%,第二天 78%,回源带宽回落到 96Mbps。比加版本号省得多,也比全站 no-cache 省掉每次 180ms 的往返。

另外把 HTML 也纳进来。之前 HTML 一律 no-store,每次都回源。改成带 ETag 的短缓存,60 秒,配合发版主动刷新,回源又降了一截。

测试时发现 If-None-Match 里可能带多个值,用逗号分隔,直接整串比较永远不相等。要先拆开再逐个比,这一步漏了,弱网下 304 命中率只有 12%。

踩了个坑:ETag 的值必须带双引号,少了引号 Chrome 会当成弱校验直接忽略,行为退回按时间判断。这个在 curl 里看不出来,只有拿浏览器验才发现。

后来把这段逻辑抽成公共函数,所有动态输出的 css 和 js 都走它。验证方法很简单,连续两次请求第二次回 304,改一个字符后再请求回 200,就对了。这套改法对 CDN 也有效,边缘回源带条件头,命中 304 就不再传文件。上线后每周看一次命中率,掉到 60% 以下就查是不是有人又加了版本参数。

您可以还会对下面的文章感兴趣: