香港服务器接入 CDN 后缓存未命中,怎样区分缓存规则、回源响应与对象变化?

发布人:A5数据发布时间:2026-10-17 15:45阅读量:95

缓存未命中不一定表示 CDN 配置失效。页面每次都回源,可能是缓存规则没有匹配、请求被判定为不可缓存、对象已过期,也可能是源站每次返回了不同内容或缓存键随请求变化。排查时要把同一 URL、同一请求条件下的边缘响应与源站响应对照起来;只看浏览器页面或单个 MISS 标记,通常不足以确定原因。

香港服务器接入 CDN 后,用户访问的边缘节点、CDN 回源链路和源站应用是不同环节。先确认未命中出现在哪些 URL、请求方法和地区,再沿着“边缘规则与缓存键—回源响应—对象内容及变化”逐层检查,可以避免把对象更新、Cookie 差异或边缘节点差异误判成配置问题。

问题树诊断配图

先确认:什么现象才算持续未命中

CDN 厂商对缓存状态的命名并不完全一致。响应头中可能出现 HIT、MISS、BYPASS、EXPIRED、REVALIDATED 等值,也可能使用其他字段;有些服务还会显示上游状态。判断时先找到服务商文档中对应的缓存状态字段,再结合响应头、CDN 日志和源站访问日志核实,不要把某个厂商的字段名直接当作通用标准。

这些状态通常可作如下理解,但具体语义以 CDN 服务配置为准:

观察到的状态常见含义优先检查
HIT当前边缘节点直接返回了缓存对象状态对应的缓存键、对象版本和内容是否正确
MISS当前请求没有可直接返回的缓存对象,可能触发回源缓存键、缓存规则、对象是否首次请求或已被清除
BYPASS请求被规则或请求特征排除在缓存之外Cookie、请求头、请求方法及绕过缓存规则
EXPIRED对象已过期,CDN 需要重新取源或验证TTL、源站缓存头、重新验证结果
REVALIDATEDCDN 与源站验证对象后,可能继续使用未变化的内容ETag、Last-Modified 和条件请求处理

先用一条确切的 URL 建立观察对象,并固定请求方法、查询参数和重要请求头。至少记录:访问时间、请求 URL、HTTP 状态码、缓存状态、Age、Cache-Control、Expires、ETag、Last-Modified、Vary、Set-Cookie,以及 CDN 返回的请求标识。不是每个响应都会有这些字段;缺失本身不一定是故障。

可用 curl 查看响应头。以下命令中的域名和路径需要替换为实际值:

curl -sS -D - -o /dev/null \
  'https://www.example.com/assets/app.css'

如果连续请求后状态从 MISS 变成 HIT,通常说明对象可被缓存,只是首次请求、边缘节点冷缓存或对象刚被清除。如果每次都是 MISS,应继续确认请求是否落在同一边缘节点、缓存键是否一致,以及响应是否具备可缓存条件。若状态为 BYPASS,先查绕过条件,不要先提高 TTL。

建立原因树:按边缘、回源和对象变化分支

遇到未命中,可先把问题拆成三个分支:

建立原因树:按边缘、回源和对象变化分支配图

  1. 边缘没有使用已有对象:规则未匹配、缓存键发生变化、请求被绕过,或边缘节点本身没有该对象。
  2. 源站响应不允许或不适合缓存:状态码、缓存头、Cookie、Vary 或 CDN 的缓存策略使对象不入缓存。
  3. 对象确实变化或不断失效:部署、清除缓存、TTL 到期、文件版本变化或源站内容协商造成新对象。

再根据影响范围缩小分支:

  • 单个路径或文件异常:优先检查路径规则优先级、文件后缀、查询参数和该响应的源站头。
  • 一个目录或一类资源异常:检查按目录、后缀、内容类型或状态码设置的缓存策略。
  • 全站或多个资源同时异常:检查 CDN 全局规则、回源配置、缓存键模板、站点级绕过策略和源站响应是否整体改变。
  • 仅部分地区或部分时段异常:核对访问是否落在不同边缘节点、节点是否刚被清除或尚无缓存,并对照时间和请求标识。
  • 仅带登录态或特定请求头时异常:检查 Cookie、鉴权头、语言或压缩协商是否参与缓存键,或者触发了绕过规则。

香港源站的位置不会直接决定缓存是否命中,但会影响回源链路。若未命中时延上升,同时源站日志显示请求增加、回源耗时变长,可以说明问题已经传到回源路径;这仍不能单独证明源站响应是未命中的根因。

逐层排除:先看缓存规则与请求是否一致

1. 核对规则命中顺序和匹配对象

进入 CDN 控制台检查当前生效的缓存规则,而不只看规则草稿。重点核对:

  • 规则匹配的是主机名、路径、后缀、查询参数,还是其中的组合。
  • 是否区分大小写、是否对目录末尾斜杠作不同处理,以及 URL 规范化规则如何执行。
  • 多条规则发生重叠时,优先级、先匹配即停止还是继续覆盖。
  • 是否有更高优先级的“绕过缓存”“动态内容”或“按源站头处理”规则。
  • 规则是否已发布到当前站点、域名和环境,而非仅保存未生效。

例如,缓存规则写成 /assets/,实际请求却是 /Assets/app.css,是否匹配取决于 CDN 的路径匹配方式。类似地,/image?id=10 与 /image?id=11 是否属于同一缓存对象,要看查询参数是否纳入缓存键;如果规则忽略所有查询参数,动态图片或个性化接口还可能被错误复用,不能为了提高命中率而盲目忽略参数。

发现规则疑点时,先选一个无登录态、无敏感内容的静态对象,用相同 URL 连续请求并记录状态。若规则调整后状态仍为 BYPASS,检查绕过条件和请求特征;若变成 MISS 后再变为 HIT,则边缘已经开始存储对象,下一步还需验证内容正确、TTL 生效和不同节点表现。

2. 检查缓存键是否因请求差异而分裂

缓存键决定 CDN 将哪些请求视为同一个对象。常见组成部分包括主机名、路径、查询参数,也可能包含指定请求头、Cookie、设备类型或压缩格式。缓存键包含的维度越多,请求被分到不同对象的可能性越大。

逐层排除:先看缓存规则与请求是否一致配图

对同一路径,比较以下请求是否完全一致:

  • 查询参数的名称、顺序以及是否包含追踪参数。
  • Cookie、Authorization、语言、设备类型等请求头。
  • 主机名、HTTP 与 HTTPS 访问方式、尾部斜杠。
  • Accept-Encoding 等内容协商请求头。
  • 请求方法,以及是否带有 Range 分段请求。

可用 curl 分别发起不带 Cookie 和带 Cookie 的请求,观察缓存状态是否变化。以下是示例:

curl -sS -D - -o /dev/null \
  'https://www.example.com/page'

curl -sS -D - -o /dev/null \
  -H 'Cookie: session=REDACTED' \
  'https://www.example.com/page'

若无 Cookie 时命中、有 Cookie 时绕过或持续未命中,可能是 CDN 配置按 Cookie 绕过,也可能是源站响应带有个性化标记。不要把所有 Cookie 从缓存键中移除:登录页、购物车、账户信息等内容若被不同用户共享,会造成数据泄露。只有确认内容对该维度确实相同,才考虑缩减缓存键或配置安全的缓存规则,并先在非敏感静态对象上验证。

查询参数也要按业务语义区分。?v=20250301 可能是静态资源版本号,参与缓存键有助于发布新版本;?utm_source=... 可能只是追踪参数,是否忽略要结合应用行为确认。参数顺序、重复参数和空值的规范化方式,应以 CDN 实际缓存键规则为准。

3. 分清“没有缓存对象”和“请求明确绕过”

若状态为 BYPASS,检查 CDN 中是否存在按路径、Cookie、请求头、方法或源站响应头设置的绕过条件。也要核对请求是否使用了不缓存的方法:一般缓存场景以 GET、HEAD 为主,POST 等方法通常不应按静态对象方式缓存,具体支持范围依服务商而异。

若状态为 MISS,但源站日志每次都有对应请求,可能是对象未存储、缓存键每次不同、TTL 太短或对象频繁失效。若 CDN 日志没有回源记录,则该状态可能代表边缘节点本地没有对象、请求被其他层拦截,或日志字段含义与预期不同。用 CDN 请求标识关联日志,并按服务商对状态字段的定义解释。

首次请求在边缘节点产生 MISS 并不异常。CDN 通常按节点保存对象;一个节点命中,不代表所有地区、所有节点都已经预热。比较前后结果时,尽量在短时间内对同一地区、同一入口和同一 URL 连续请求,并记录节点标识。跨地区测试可用于发现差异,但不能只凭两个地区的结果断定规则配置错误。

逐层排除:检查源站响应是否支持缓存

当缓存规则看起来匹配、请求条件一致,下一步检查 CDN 实际收到的源站响应。源站可以通过响应头、状态码或响应内容影响 CDN 是否缓存;CDN 也可能按照控制台规则覆盖或忽略部分源站头,因此要同时核对两侧配置。

1. 查看缓存控制头和状态码

常见相关响应头包括:

  • Cache-Control:例如 public、private、no-store、no-cache、max-age、s-maxage。
  • Expires:提供过期时间;它与 Cache-Control 的优先关系应按 HTTP 规则和 CDN 配置判断。
  • Set-Cookie:可能触发不缓存或按 Cookie 区分,但处理行为取决于 CDN 策略。
  • Vary:声明响应会随哪些请求头变化;若包含 Cookie、Accept-Language 等维度,需确认 CDN 是否正确处理。
  • HTTP 状态码:不少 CDN 默认只缓存部分成功响应,错误响应是否缓存、缓存多久通常有独立策略。

no-cache 通常表示使用前需要验证,而不是简单等同于“绝不保存”;no-store 则表达不应存储。CDN 产品可能有强制 TTL 或缓存覆盖选项,因此看到这些字段后,既要查源站,也要查 CDN 的“遵循源站头、忽略源站头、覆盖 TTL”设置。

以下命令可查看经过 CDN 的响应头,但不能保证得到未经 CDN 修改的源站原始头:

curl -sS -D - -o /dev/null \
  'https://www.example.com/assets/app.css'

如果 CDN 控制台提供回源响应头、回源日志或调试信息,应优先使用这些记录。如果需要直连源站对照,可在网络和访问策略允许、且掌握源站 IP 的前提下,用 --resolve 保持 TLS 主机名与证书校验目标不变:

curl -sS -D - -o /dev/null \
  --resolve www.example.com:443:203.0.113.10 \
  'https://www.example.com/assets/app.css'

示例 IP 203.0.113.10 是文档专用地址,需替换为实际源站地址。若源站只接受 CDN 回源 IP,直连失败并不表示源站故障;也不要为测试而关闭源站访问控制。直连结果只代表这次源站响应,仍需与 CDN 回源日志、相同请求头和时间点对照。

2. 检查响应是否因用户或请求而变化

同一个 URL 可能根据 Cookie、语言、设备、鉴权状态或请求头返回不同内容。源站若对不同请求返回不同正文,却未通过 Vary 或缓存键区分,可能导致错误复用;若 CDN 为这些维度分别建键,则会增加对象数量、降低命中率。

可在源站访问日志中查看请求方法、路径、状态码、响应字节数、耗时和请求标识;应用日志可补充用户态、语言、版本号等非敏感维度。不要把完整 Cookie、Authorization 或个人信息直接写入公开日志或排障记录。对比响应时可计算文件哈希,判断正文是否一致:

curl -sS 'https://www.example.com/assets/app.css' | sha256sum

示例输出中的哈希只用于比较同一文件的内容;哈希变化说明响应正文不同,但不说明变化是由部署、压缩、动态生成还是源站节点差异造成,仍需结合响应头和应用日志判断。

3. 区分源站不可缓存与 CDN 没有遵循源站头

一种常见误判是:看到响应带 Cache-Control: no-cache,就认定 CDN 必然不会存储;或看到控制台配置了缓存 TTL,就认定源站头已无影响。实际结果取决于两者的优先级配置。

逐项确认:

  1. CDN 规则是遵循源站缓存头,还是覆盖源站 TTL。
  2. 源站是否在应用层、Nginx 或其他上游组件中添加了缓存头。
  3. 不同状态码、目录和内容类型是否套用不同 TTL。
  4. 响应是否带有 Set-Cookie,以及 CDN 对该字段的缓存处理策略。
  5. 源站是否返回重定向或错误状态,而不是预期的 200。

如果源站每次返回相同的静态文件,但带 private 或 no-store,并且 CDN 遵循该响应头,那么问题属于回源响应与缓存策略不匹配。要调整时,应先确认对象能否被所有访客安全共享,再修改应用或 CDN 配置;动态用户内容不应仅为追求命中而改成公共缓存。

A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡及马来西亚等地区的物理服务器资源,可作为CDN回源的源站基础。香港服务器覆盖常规建站、Xeon Gold和AMD EPYC等配置,并提供SSD或NVMe存储及不同带宽线路,适合承载网站、业务后台、数据库和接口服务;多地区节点与多样化硬件资源,也便于为不同访问区域和业务负载搭建相应的源站环境。

定位根因:确认对象是否在变化或反复失效

规则和回源头都符合预期,但对象仍频繁未命中时,重点检查对象生命周期。常见情况包括 TTL 到期、主动清除、部署后文件变化、版本参数改变,或源站响应中的验证器发生变化。

TTL 到期、清除与重新验证

观察缓存状态、Age 和 CDN 清除记录。如果 Age 逐渐增长后状态转为 EXPIRED、MISS 或 REVALIDATED,且时间间隔接近配置 TTL,通常说明对象按预期过期;如果状态刚命中就再次未命中,则应查是否发生主动清除、规则变更或缓存键变化。

定位根因:确认对象是否在变化或反复失效配图

Age 表示对象在共享缓存中的年龄线索,不保证所有 CDN 都以相同方式返回,也不等于源站文件的生成时间。源站响应若有 ETag 或 Last-Modified,CDN 过期后可能发起条件请求;源站返回 304 Not Modified 时,CDN 可能更新缓存元信息并继续提供已有正文。此时“请求回源”不代表每次都重新传输了完整对象。

部署和文件版本变化

静态资源采用内容哈希文件名,例如 app.a1b2c3.css,通常比长期复用同一文件名更容易安全缓存:内容变化时 URL 变化,旧对象不会与新内容混淆。若部署覆盖固定路径 app.css,则需要明确清除策略、TTL 和客户端缓存策略。要确认是否真的发生对象变化,可对照:

  • CDN 与源站的 ETag、Last-Modified 和正文哈希。
  • 部署时间、发布版本、文件修改时间及静态资源清单。
  • CDN 清除记录、规则发布记录和缓存键变化。
  • 多台源站或不同应用实例返回的版本是否一致。

若同一请求在不同时间得到不同哈希,而源站节点或版本标识也不同,问题可能在发布同步或负载均衡后的源站内容不一致,不应只靠清除 CDN 缓存处理。清除后若边缘重新回源,仍可能从不一致的源站节点取到不同版本。

用日志把边缘与源站对应起来

假设某静态文件连续请求两次:第一次边缘返回 MISS,源站日志记录一次 200;第二次边缘返回 HIT,源站没有新增请求。这更符合首次填充缓存的过程。若每次都返回 MISS,源站每次都有 200,且源站响应带 Cache-Control: private,则优先检查源站头与 CDN 遵循策略。若状态持续 BYPASS,源站访问日志是否增长取决于绕过后的回源行为,但应先查请求特征和绕过规则。

以上是模拟判断场景,不代表任何特定环境的检查结果。实际排障时,最好用 CDN 请求标识关联边缘日志、回源日志和源站访问日志。没有统一请求标识时,可用时间、路径、方法、状态码和客户端信息辅助关联,但要注意时钟偏差、日志延迟和多层缓存造成的差异。

验证恢复:用相同条件复测,而不是只看一次命中

找到根因并调整后,先使用一条明确、可重复的测试请求验证。不要同时修改缓存键、TTL、源站头和绕过规则,否则即使恢复也难以确认是哪项变更起效。

建议按以下顺序验证:

  1. 记录变更前状态:保存规则配置、目标 URL、请求头、缓存状态、响应头和请求标识。修改规则前导出或截图当前配置,避免误改其他路径。
  2. 只调整对应分支:规则不匹配就修正匹配条件;缓存键分裂就处理相关维度;源站头不适合共享缓存就先确认业务安全边界;对象反复变化则核查部署和清除流程。
  3. 处理旧对象:只有在旧对象可能继续被返回、且确认清除范围可控时,才按厂商支持的方式清除指定 URL 或路径。清除全站缓存可能导致大量回源和源站负载上升;先确认影响范围与回滚或恢复方案,不要把全站清除当成常规验证动作。
  4. 连续复测同一请求:固定 URL、方法和请求头,观察首次请求与后续请求的状态、Age 和源站日志。预期缓存的对象通常会经历填充后命中,但不同节点、过期策略和厂商状态定义可能不同。
  5. 核对内容正确性:比较边缘返回与源站预期版本的状态码、关键响应头和正文哈希。只看到 HIT 不代表缓存内容正确,也不代表用户个性化内容没有被错误共享。
  6. 扩大观察范围:在不改变请求条件的前提下,对目标目录内的代表性资源、不同访问地区和无登录态请求分别检查;再按业务需要测试带 Cookie 或特定请求头的场景。

如果调整后变成 MISS 后再 HIT,且内容正确、源站请求次数相应下降,可以认为该测试对象的缓存链路已恢复。若仍为 MISS,根据结果分流:缓存状态为 BYPASS 时回到绕过条件;每次 MISS 且源站头不允许缓存时检查响应策略;Age 增长后过期时检查 TTL 是否符合预期;不同节点正文不一致时检查源站发布一致性和缓存清除记录。

复发监控:关注“为什么未命中”,不只看命中率

单独监控全站命中率容易掩盖问题:动态接口本来就可能不缓存,而静态资源持续未命中则可能是故障。可按站点、路径类别、状态码和地区拆分观察,并把边缘请求与回源请求关联起来。

建议至少关注以下指标和事件:

  • 按静态资源、HTML、API 等类别统计缓存状态分布,重点观察 BYPASS、MISS、EXPIRED 是否异常上升。
  • 回源请求量、回源字节数、源站响应时间和错误码,判断未命中是否增加了源站压力。
  • 规则发布、缓存键变更、TTL 调整和缓存清除记录,并保留操作人、时间与影响范围。
  • 关键静态文件的 ETag、版本号或哈希变化,及不同源站实例返回内容是否一致。
  • 带 Cookie、语言头、查询参数的代表性请求,确认缓存隔离和个性化边界仍符合预期。

阈值应结合业务基线设置。例如,静态资源在发布后短时间出现 MISS 可能是正常填充;若非发布时段持续未命中,同时回源量明显升高,则值得告警和复查。真正需要追踪的是“哪些请求为何未命中、是否因此回源、回源后得到什么响应”,而不是要求所有内容都缓存或把命中率单一指标当作配置正确性的证明。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4269.html

相关推荐