一、基础知识

CDN 的作用是把源站内容放到离用户更近的边缘节点。一次请求的链路大致是:浏览器 → CDN 边缘节点 → 源站。浏览器和 CDN 都会缓存,所以"缓存不生效"要先分清是浏览器缓存还是 CDN 缓存的问题。

控制缓存的核心是响应头。最常见的是 Cache-Control,几个高频指令要分清:

  • max-age=秒数:资源在多少秒内是"新鲜"的,期间可直接使用缓存。
  • no-cache:不是不缓存,而是每次使用前必须向源站校验是否变化。
  • no-store:真正的不缓存,任何环节都不保存。
  • public / private:是否允许 CDN 等共享缓存存储。

还有两个"协商缓存"字段:ETag(资源的唯一标识,类似指纹)和 Last-Modified(最后修改时间)。浏览器或 CDN 下次请求时带上 If-None-Match(值为上次拿到的 ETag),源站比对后发现没变,就返回 304 Not Modified,不带正文,体积很小。

实际排查时可以把缓存分成两类来理解:强缓存直接用本地副本、不发请求,由 max-age 和 Expires 控制;协商缓存要发请求问一句,靠 ETag 和 Last-Modified 判断,命中就返回 304。两者通常配合工作:新鲜期内走强缓存,过期后走协商缓存。还要留意"回源"这个概念——CDN 没命中时向源站取数据的过程。如果命中率很低,大量请求同时回源,源站压力会陡增。所以缓存不生效不只是"用户看到旧内容"这么简单,还可能把源站拖垮。

判断 CDN 是否命中,看响应里是否有厂商提供的缓存状态头,例如 X-Cache: HIT 表示命中、MISS 表示回源,Age 表示这个副本在 CDN 上已经存了多少秒。另外要注意缓存键:CDN 通常用 URL(含域名、路径,有时含查询参数)作为键,并受 Vary 头影响。两个看起来相似但键不同的请求,会被当成两份缓存。

二、实操步骤

下面以文档地址 example.com 的静态资源为例,演示排查全过程。

第 1 步:查看完整响应头。

curl -I https://example.com/static/app.css

第 2 步:只提取缓存相关字段,快速判断状态。

curl -sI https://example.com/static/app.css | grep -iE 'cache-control|expires|etag|last-modified|age|x-cache|vary'

如果看到 X-Cache: MISS 且 Cache-Control 的 max-age 很小,说明 CDN 没缓存住;看到 HIT 但内容是旧的,说明缓存还没过期或没刷新。

第 3 步:验证 ETag 协商是否生效。 先取 ETag,再带上它请求:

# 取出 ETag 的值
etag=$(curl -sI https://example.com/static/app.css | grep -i '^etag:' | tr -d 'r' | cut -d' ' -f2-)
# 带上 If-None-Match 请求,没变化应返回 304
curl -sI -H "If-None-Match: $etag" https://example.com/static/app.css

第 4 步:在源站设置合理的缓存头。 以 Nginx 为例,用下面的命令写入配置并重载:

sudo tee /etc/nginx/conf.d/static.conf >/dev/null <<'EOF'
server {
    listen 80;
    server_name example.com;
    location ~* .(css|js|png|jpg|woff2)$ {
        add_header Cache-Control "public, max-age=604800" always;
    }
}
EOF
sudo nginx -t && sudo systemctl reload nginx

注意:/etc/nginx/conf.d/*.conf 是被 http{} include 的,而 location 只能写在 server{} 或另一个 location{} 里,直接把裸 location 放进这个文件会在 nginx -t 时报 [emerg] "location" directive is not allowed here,所以上面用一层 server 块把它包住。缓存头只用一个 add_header 同时给出 public 与 max-age(7 天 = 604800 秒),不要再叠加 expires 7d;,否则会同时生成两个 Cache-Control 头。

第 5 步:验证配置生效。 再次执行第 2 步的命令,确认 Cache-Control 已变成预期值,多请求几次观察 X-Cache 是否从 MISS 变为 HIT。

三、关键细节

  1. Cache-Control 优先级高于 Expires。 两者都存在时以 Cache-Control 为准,别只盯着旧的 Expires 头看。
  2. no-cache 的语义最容易搞错。 它要求"每次校验",并不是"禁止缓存";真正禁止存储的是 no-store。
  3. 协商缓存仍会产生请求。 304 虽然不传正文,但仍有一次往返,不能理解为"零请求",高频小文件要考虑这个开销。
  4. Vary 会把缓存拆成多份。 比如 Vary: Accept-Encoding 会让压缩和未压缩版本分别缓存,不同客户端拿到的可能不是同一份。
  5. 查询参数可能进入缓存键。 /app.css?v=1 和 /app.css?v=2 往往是两份缓存,刷新时别漏掉带参数的地址。
  6. Age 头很有用。 它告诉你副本已经存了多久,结合 max-age 就能判断是否快过期。
  7. 浏览器缓存会掩盖 CDN 的真实状态。 排查 CDN 时建议用无痕窗口,或给地址加一个随机查询参数,避免浏览器自己的缓存干扰判断。看清 CDN 是否命中,要以 curl 这类不带浏览器缓存的请求为准。

四、常见错误

现象 原因 修正
资源更新后用户仍看到旧版 文件名没变,且 CDN 缓存还没过期 改用带内容哈希的文件名(指纹),或在发布后按官方文档刷新对应 URL
curl 显示 MISS,但浏览器里像是命中 两者的请求头、协议或缓存键不同 统一用同一地址与相同请求头复现,对比 Vary 相关字段
源站有 Cache-Control,CDN 却不认 CDN 的缓存规则覆盖了源站响应头 到 CDN 控制台核对缓存规则,确认以源站头为准还是以自定义规则为准
设了 no-cache,结果完全不缓存 多半是被 CDN 规则或上游响应覆盖成了 no-store 先查 CDN 缓存规则与上游响应,确认哪个环节改成了 no-store;确需完全不存就用 no-store;要"可存但每次校验"则用 no-cache 或 max-age=0, must-revalidate
ETag 存在却每次都返回 200 请求没带 If-None-Match,或源站忽略了它 用第 3 步命令手动带上 ETag 验证源站行为
刷新后很快又变回旧内容 只刷了一个节点或一层的缓存,其他节点未同步 等待刷新全网生效,或按官方说明做目录刷新

五、排查方法

照着下面的顺序做,逐层缩小范围:

# 1. 看完整响应头,确认缓存头是否符合预期
curl -sI https://example.com/static/app.css

# 2. 提取关键字段,看 X-Cache / Age / max-age
curl -sI https://example.com/static/app.css | grep -iE 'cache-control|etag|age|x-cache|vary'

# 3. 用 ETag 验证协商缓存是否返回 304
etag=$(curl -sI https://example.com/static/app.css | grep -i '^etag:' | tr -d 'r' | cut -d' ' -f2-)
curl -sI -H "If-None-Match: $etag" https://example.com/static/app.css

# 4. 对比带查询参数的地址,排查缓存键差异
curl -sI 'https://example.com/static/app.css?v=1'

# 5. 连续请求几次,观察命中状态变化
for i in 1 2 3; do curl -sI https://example.com/static/app.css | grep -i 'x-cache'; done

先看头判断"该不该缓存",再看 X-Cache 判断"有没有缓存",最后用 ETag 验证"能不能正确更新",三步分开,问题就藏不住。

六、注意事项

  • 不同 CDN 厂商的缓存状态头名称、刷新接口和规则优先级都不一样,本文用通用字段举例,具体操作以对应官方文档为准,不要照搬字段名称。
  • 缓存刷新通常有生效延迟,全网节点同步需要时间,刷新完立刻验证可能还是旧结果。
  • 含用户隐私或鉴权信息的响应不要设为 public 缓存,必要时用 private 或 no-store,避免数据串号。
  • 文中 example.com 为文档保留域名,仅用于演示命令写法,请勿替换为真实第三方站点测试。

免责声明:本文为个人学习与实操经验总结,仅代表个人观点,不构成任何技术或商业决策建议。不同系统环境与版本可能存在差异,实际操作请以官方文档为准并自行验证。