核心是确认cdn缓存键与源站实际响应是否匹配:通过curl -i检查x-cache、age、via等响应头,比对不同参数请求的命中状态与内容差异,再结合cdn控制台缓存键规则(如是否忽略参数)及源站vary/cache-control头综合判断。

排查 CDN 节点与源站缓存键不一致,核心是确认“CDN 认为该缓存什么”和“源站实际返回什么”是否对得上。两者错位,就会出现不同参数请求命中同一缓存、或相同请求在不同节点返回不同内容的问题。
看响应头里的缓存标识字段
用 curl -I 或浏览器开发者工具的 Network 面板,抓取一个带参数的请求(如 /product?id=123&utm_source=wechat),重点检查以下字段:
- X-Cache:显示是否命中 CDN 缓存(HIT/MISS/MISS from cache);
- Age:当前响应在 CDN 节点已缓存多少秒,非零说明确实被缓存了;
-
Via:能看出经过哪一层代理,比如
via edge-4289.shenzhen.cdn.com表示命中深圳边缘节点; - X-Edge-Cache(腾讯 EdgeOne)或 X-Cache-Hits(部分 CDN):更细粒度的缓存路径记录。
比对不同参数请求的缓存行为
发起两个仅参数不同的请求,例如:
GET /api/banner?loc=shanghaiGET /api/banner?loc=beijing
如果两者都返回 HIT,且 Content-Length 或 ETag 完全一样,说明 CDN 忽略了参数——但源站其实返回了不同内容,这就暴露了缓存键与业务逻辑冲突。
反之,如果两个请求都 MISS,或一个 HIT 一个 MISS,再结合缓存键配置,就能判断 CDN 是否把参数当作了缓存键的一部分。
查 CDN 控制台的缓存键规则
登录 CDN 管理后台,定位到对应域名的「缓存配置 → 缓存键规则」,重点关注:
- 是否开启「忽略全部查询参数」;
- 是否设置了「保留指定参数」(如只保留
lang、v,其余忽略); - 规则是否按路径精确匹配(比如
/static/下忽略参数,但/api/下保留); - 是否存在多条规则,后建的覆盖了前建的(优先级冲突)。
验证源站真实输出是否随参数变化
绕过 CDN 直连源站(改 hosts 或用 curl 指定 Host + --resolve),重复发送带参请求:
- 对比响应体是否真有差异(比如 JSON 中的文案、图片 URL 不同);
- 检查源站是否返回了
Cache-Control: no-cache或Vary: User-Agent, Accept-Language等头——这些会直接影响 CDN 如何构造缓存键; - 若源站用了
Vary头,CDN 必须将对应请求头也纳入缓存键,否则必然不一致。











