一、基础知识
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。
三、关键细节
- Cache-Control 优先级高于 Expires。 两者都存在时以 Cache-Control 为准,别只盯着旧的 Expires 头看。
- no-cache 的语义最容易搞错。 它要求"每次校验",并不是"禁止缓存";真正禁止存储的是 no-store。
- 协商缓存仍会产生请求。 304 虽然不传正文,但仍有一次往返,不能理解为"零请求",高频小文件要考虑这个开销。
- Vary 会把缓存拆成多份。 比如
Vary: Accept-Encoding会让压缩和未压缩版本分别缓存,不同客户端拿到的可能不是同一份。 - 查询参数可能进入缓存键。
/app.css?v=1和/app.css?v=2往往是两份缓存,刷新时别漏掉带参数的地址。 - Age 头很有用。 它告诉你副本已经存了多久,结合 max-age 就能判断是否快过期。
- 浏览器缓存会掩盖 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为文档保留域名,仅用于演示命令写法,请勿替换为真实第三方站点测试。
免责声明:本文为个人学习与实操经验总结,仅代表个人观点,不构成任何技术或商业决策建议。不同系统环境与版本可能存在差异,实际操作请以官方文档为准并自行验证。

评论
还没有评论,来说两句吧。