CDN缓存错误页面多久合适,怎样设置失效与回源?

发布人:A5数据发布时间:2026-11-11 11:13阅读量:49

很多人会把“错误页面”直接等同于“不应缓存”,但实际情况并非如此:404、403、429、500、502、503 的产生原因和恢复速度不同,适合的缓存时间也不同。一个已经确认永久不存在的静态文件,可以缓存较长时间;而权限判断、限流结果或临时故障页面,通常应缩短缓存时间,甚至完全禁止缓存。

如果没有业务数据作为依据,可以先采用这样的起点:普通动态页面的 404 缓存 60~300 秒,确认永久不存在的版本化静态资源缓存 10~60 分钟;403、429 通常控制在 0~10 秒;500、502、503 默认不缓存,或只设置 1~30 秒的极短缓存。页面恢复后需要立即可见时,优先使用精确 URL 失效、标签失效或版本化 URL,而不是单纯等待 TTL 到期。

一、先划清“错误缓存”的边界

1. 缓存的是响应,不只是错误页面文件

CDN 缓存的基本单位通常是一次 HTTP 响应。它可能包含:

  • 请求 URL;
  • HTTP 状态码,例如 404 或 503;
  • 响应头,例如 Cache-Control、ETag;
  • HTML、JSON、图片或其他响应正文;
  • CDN 根据规则生成的自定义错误页面。

因此,“缓存错误页面”至少有两种情况。

第一种是源站实际返回 404,CDN 把这次 404 响应保存下来。之后即使源站已经补上文件,CDN 仍可能继续返回旧的 404,直到 TTL 到期、重新验证或执行失效。

第二种是源站返回错误后,CDN 在边缘节点生成统一的错误页。例如源站返回 503,CDN 把响应正文替换成 /errors/503.html。此时至少存在两个需要区分的对象:

  1. 原始请求对应的错误响应;
  2. 被引用的自定义错误页资源。

只清理 /errors/503.html,不一定能清理已经缓存的原始请求 503;反过来也一样。具体是否分开缓存,取决于 CDN 的错误响应规则和缓存实现,需要通过响应头和控制台规则确认。

一、先划清“错误缓存”的边界|1. 缓存的是响应,不只是错误页面文件配图

2. HTTP 状态码不等于缓存策略

状态码只能说明请求结果,不能单独决定缓存时间。

  • 404 Not Found 可能是临时发布延迟,也可能是确认删除的资源;
  • 403 Forbidden 可能是所有人都无权访问,也可能只对当前用户无权访问;
  • 429 Too Many Requests 通常与客户端、账号或 IP 有关;
  • 500、502、503 可能是源站短暂故障,也可能会持续很久;
  • 自定义错误页可能仍然保留原始 404 或 5xx 状态,也可能被错误地转换成 200。

如果响应内容随用户身份、Cookie、Authorization、IP 或地区变化,就不能把它当成所有访问者共享的普通页面缓存。否则可能出现“一个用户看到的错误结果被其他用户复用”的问题。

3. “缓存时间”至少有三层含义

设置错误页面时间时,应区分以下三个概念:

层级作用常见控制方式
浏览器缓存控制单个访问者本地是否继续使用旧响应max-age、no-store
CDN共享缓存控制边缘节点保存响应多久s-maxage、CDN控制台规则
回源重新验证判断过期对象是否向源站确认ETag、Last-Modified、条件请求

例如:

Cache-Control: public, max-age=0, s-maxage=120, must-revalidate

表示浏览器不应直接长时间使用,CDN可以共享缓存 120 秒,过期后需要向源站重新确认。

而:

Cache-Control: no-store

通常表示浏览器和共享缓存都不应保存该响应。不同 CDN 可能存在规则覆盖,因此最终还要以边缘响应验证结果为准。

二、CDN如何处理错误响应、失效和回源

1. 首次请求、命中和过期

以一个不存在的 /assets/app.js 为例:

  1. 访问者第一次请求,边缘节点没有对象,状态为 MISS;
  2. CDN 向源站请求,源站返回 404;
  3. CDN根据缓存规则决定是否保存这个 404;
  4. 其他访问者再次请求同一缓存键;
  5. 在 TTL 未到期时,CDN直接返回已保存的 404;
  6. TTL 到期后,CDN可能回源重新获取结果。

如果源站在第 3 步返回:

HTTP/1.1 404 Not Found
Cache-Control: public, max-age=0, s-maxage=120, must-revalidate
Content-Type: text/html; charset=utf-8

则示例含义是:该 404 可在 CDN 中保存 120 秒,之后需要重新验证。这里的 120 秒是示例值,实际应根据资源发布周期和错误恢复速度调整。

2. TTL 到期不一定代表重新下载完整页面

如果源站为错误响应提供了验证器,例如:

ETag: "error-page-v3"
Last-Modified: Tue, 12 Mar 2024 08:00:00 GMT

CDN 到期后可以发送条件请求:

If-None-Match: "error-page-v3"

如果源站返回 304 Not Modified,CDN可以继续使用已有正文,并刷新缓存时间;如果状态已经从 404 变成 200,则CDN会获取新的正文和状态。

因此,“回源”并不一定意味着每次都传输完整页面,但仍会产生一次源站请求和相应的处理开销。

3. 失效与回源不是同一件事

常见操作的效果如下:

操作主要效果是否必然立即请求源站
等待 TTL 到期让对象自然进入重新验证阶段否,可能等待下一次访问
URL 精确失效删除指定缓存键下一次请求通常需要回源
路径或前缀失效批量删除一组对象下一次访问各对象时分别回源
标签失效删除具有同一标签的对象取决于CDN是否支持标签
请求带 no-cache要求重新验证当前请求取决于CDN是否遵守该请求头
no-store禁止响应被存储通常不建立可复用缓存
修改查询参数可能生成新的缓存键不一定清除旧查询键

失效操作本质上是删除或标记旧对象,回源则是重新向源站获取结果。部分 CDN 存在多级缓存、回源集群或缓存预热层,控制台显示“失效成功”后,个别边缘节点仍可能在短时间内返回旧内容。因此要把失效任务状态和实际请求验证分开判断。

CDN缓存错误响应、执行失效后重新回源,背后都离不开稳定的源站与相匹配的计算、存储和网络资源。A5idc数据提供香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,可为网站、业务后台、数据库及接口服务提供部署基础;不同系列配有SSD或NVMe存储,并提供多种CPU与线路方案,便于承载源站请求及业务数据。

4. 负缓存会造成“文件已恢复但仍然404”

对 404 的缓存通常被称为负缓存。它可以减少恶意扫描、拼写错误或热点不存在 URL 对源站的重复请求,但也会带来发布延迟。

例如:

  • 00:00,访问 /download/manual.pdf,源站返回 404;
  • 00:00,CDN将 404 缓存 300 秒;
  • 00:01,源站上传并发布 manual.pdf;
  • 00:02,访问者仍可能得到 CDN 缓存的 404;
  • 00:05 左右,TTL 到期后才有机会回源得到 200。

如果发布系统无法在文件上线时自动执行 URL 失效,404 TTL 就不宜设置过长。对于带版本号的静态资源,例如 /app.20240312.js,发布后通常不会再修改同一个路径,负缓存可以更长;对于固定路径的文件,则应缩短 404 TTL 或接入发布后的精确失效。

三、不同错误类型应该设置多久

下表是适合做初始策略的典型范围,不是所有业务的固定标准。

错误类型常见原因CDN缓存起点需要重点注意
404路径错误、发布延迟、资源不存在60~300秒固定 URL 的资源发布后可能被旧 404 遮挡
410已确认永久移除300~3600秒只有在确认不会恢复时才适合较长缓存
403权限、ACL、签名或防盗链0~10秒用户相关结果通常不应共享缓存
429访问频率超限0~5秒应结合 Retry-After,不要把单个用户的限制扩散给所有人
500应用异常、代码错误0~10秒默认不缓存更安全
502网关或上游响应异常0~10秒检查回源连接和上游健康状态
503过载、维护、服务暂不可用0~30秒维护页可单独设计,避免掩盖真实故障
504回源超时0~10秒长时间缓存会放大源站恢复后的不可见窗口

1. 404和410:按“恢复可能性”区分

404 不代表资源永远不存在。常见的短缓存场景包括:

  • 静态文件刚上传,CDN可能先于源站收到请求;
  • 多节点发布尚未完成;
  • 页面由异步任务生成;
  • URL包含日期或版本,但生成任务存在延迟;
  • 用户可能在短时间内重新创建同一路径。

如果资源确实永久删除,且客户端不应继续等待恢复,可以使用 410,并设置更长的负缓存。但删除策略应与内容管理、搜索引擎处理和回滚流程保持一致,不能仅为了减少回源而把暂时不存在的资源改成 410。

2. 403和429:最容易出现缓存串用户

403 和 429 的返回结果经常与访问身份有关。例如:

  • A 用户无权访问某文档,B 用户有权访问;
  • 某 IP 超过频率限制,其他 IP 仍然正常;
  • 签名 URL 过期时间各不相同;
  • Cookie 中的登录状态影响权限判断。

这类响应如果使用相同缓存键,就可能导致错误结果被错误复用。默认策略可以使用:

Cache-Control: private, no-store

如果业务确认 403 是所有访问者都一致的边缘规则结果,且缓存键已经包含必要的地区、租户或认证维度,才考虑使用很短的共享缓存,例如 1~5 秒。

429 也应优先遵循源站返回的 Retry-After。如果限流结果是按用户或 IP 计算的,CDN不应把它作为一个不区分访问者的公共页面缓存。

3. 500、502、503、504:短缓存和“提供旧内容”要分开

临时故障期间,缓存 500 或 503 可以减少源站压力,但会让所有访问者看到旧错误。对于动态页面,通常不建议把 5xx 长时间放在边缘缓存中。

另一种做法是对原本已经缓存的正常内容使用 stale-if-error。这不是缓存错误页,而是在回源失败时继续提供一份过期但正常的成功响应。例如:

Cache-Control: public, max-age=60, s-maxage=600, stale-if-error=300

示例含义是:正常内容在 CDN中可保存 600 秒;源站异常时,CDN在支持该指令且规则允许的情况下,最多继续提供 300 秒旧内容。这样通常比把 503 错误页缓存几分钟更适合图片、CSS、JS或可接受短暂陈旧的公开页面。

需要注意,stale-if-error 是否生效、是否受 CDN 配置覆盖,必须用边缘请求验证,不能只看源站响应头。

四、怎样选择页面、对象、查询和边缘层级

1. HTML页面:优先短缓存加精确失效

公开、非个性化 HTML 页面可以使用较短的共享缓存,例如 30~300 秒,并在发布时按 URL 或标签失效。

适合的方式是:

  • 页面内容更新频繁:短 TTL,依赖回源验证;
  • 页面有明确发布事件:发布后执行精确 URL 或标签失效;
  • 页面包含登录状态、购物车、账户信息:绕过共享缓存;
  • 页面错误只对当前用户成立:不要设置公共错误缓存。

如果页面中引用的 CSS、JS 使用固定文件名,HTML失效后还可能继续引用旧静态资源。因此 HTML 失效和静态对象版本管理需要同时设计。

2. 静态对象:优先版本化 URL

CSS、JS、图片、字体等对象适合使用内容哈希或版本号,例如:

/static/app.8f31c2.js
/static/site.20240312.css

版本化 URL 的优势是新内容使用新缓存键,旧对象不会阻塞新版本发布。即使旧文件曾经缓存过 404,也不会影响新版本路径。

对于固定路径的 /static/app.js,则需要在发布后执行失效。若必须快速切换,建议同时设置:

  • 正常对象较长 TTL;
  • 发布流程中的精确失效;
  • 旧版本保留一段时间,避免 HTML 和静态文件版本错配;
  • 错误响应较短 TTL,避免临时 404 长时间驻留。

3. 查询参数:先确定哪些参数参与缓存键

查询参数可能代表不同内容,也可能只是统计参数。

例如:

/product?id=1001
/product?id=1002
/product?utm_source=search

id 通常改变页面内容,应参与缓存键;utm_source 只是统计参数,很多场景可以在缓存规则中忽略,否则同一页面会产生大量近似对象。

需要特别确认三件事:

  1. CDN是否把全部查询参数纳入缓存键;
  2. 失效接口要求填写完整查询串,还是可以按基础 URL 失效;
  3. 源站是否根据被忽略的参数改变响应内容。

如果 CDN 忽略了 id,但源站又根据 id 返回不同商品,就可能发生内容串用;如果 CDN把所有追踪参数都纳入缓存键,则失效时可能需要清理大量变体。

4. 边缘自定义错误页:单独管理状态和正文

如果使用统一的 /errors/404.html、/errors/500.html,应分别确认:

  • 错误页资源本身的缓存时间;
  • 原始请求错误响应的缓存时间;
  • CDN是否保留原始状态码;
  • 错误页更新后需要清理哪些缓存键;
  • 错误页加载失败时是否会再次回源或形成错误循环。

错误页正文可以缓存较长时间,但不代表原始 500 或 404 也应缓存同样长。常见做法是让错误页静态对象稳定缓存,同时让错误状态响应保持短 TTL。

五、如何设置源站响应头和失效策略

1. 用响应头表达共享缓存意图

可以在应用或源站为不同结果返回不同策略。以下是示例,不代表必须使用相同数值。

普通可短暂共享的 404:

HTTP/1.1 404 Not Found
Cache-Control: public, max-age=0, s-maxage=120, must-revalidate
Content-Type: text/html; charset=utf-8

用户相关或敏感的 403:

HTTP/1.1 403 Forbidden
Cache-Control: private, no-store
Content-Type: application/json

临时故障响应:

HTTP/1.1 503 Service Unavailable
Cache-Control: no-store
Retry-After: 30
Content-Type: text/html; charset=utf-8

版本化静态对象:

HTTP/1.1 200 OK
Cache-Control: public, max-age=31536000, immutable
ETag: "app-8f31c2"
Content-Type: application/javascript

最后一种策略只适合 URL 已经包含可靠版本号或内容哈希的对象。如果固定 URL 直接使用一年缓存,后续发布很容易因为忘记失效而继续返回旧文件。

2. 失效粒度应与缓存键一致

可以按以下优先级选择失效方式:

  1. 单个 URL 更新:使用精确 URL 失效;
  2. 一组页面有统一发布批次:使用标签或版本标签失效;
  3. 整个目录都已替换:使用目录前缀失效,但要评估回源峰值;
  4. 资源使用版本化 URL:通常不需要清理新版本对象;
  5. 紧急错误内容:优先精确失效,再检查多节点是否全部更新。

不要把“刷新浏览器”当作 CDN 失效。浏览器可能还有自己的缓存;CDN清理也无法自动删除访问者本地已经保存的响应。若要求浏览器立即重新请求,应同时检查 max-age、no-cache 或版本化 URL。

3. 不要用访问请求头代替发布失效

有些人会尝试发送:

curl -H 'Cache-Control: no-cache' https://cdn.example.com/page.html

这只能表示本次请求希望重新验证,CDN是否遵守由其配置决定。它不会自动删除其他边缘节点中的旧对象,也不会清理浏览器、上游缓存或其他查询参数变体。

发布流程更适合调用 CDN 的失效接口或控制台功能,并记录:

  • 失效对象;
  • 失效提交时间;
  • 任务状态;
  • 是否覆盖查询参数;
  • 是否包含回源保护层或多级缓存;
  • 失效后从不同网络位置验证的结果。

六、用请求结果验证缓存时间是否生效

1. 先看源站真实结果,再看 CDN结果

验证时不要只访问 CDN域名。至少准备两个访问入口:

  • 源站直连地址,或指定源站 IP 的测试方式;
  • CDN正式域名。

如果源站启用了 Host 校验,可以使用 curl --resolve 指定解析地址。下面命令只用于读取响应头,不会修改配置:

curl -sS -D - -o /dev/null https://cdn.example.com/test-missing.html
curl -sS -D - -o /dev/null --resolve cdn.example.com:443:203.0.113.10 https://cdn.example.com/test-missing.html

其中 203.0.113.10 只是文档示例地址,应替换为实际测试地址。若源站使用不同协议、端口或证书策略,应按实际环境调整。

重点关注以下字段:

  • HTTP/1.1 404 Not Found 或 HTTP/2 404:当前状态;
  • Cache-Control:源站或 CDN 返回的缓存意图;
  • Age:对象在共享缓存中大致存活的时间;
  • ETag、Last-Modified:是否具备重新验证条件;
  • X-Cache、CDN-Cache-Status、Via:命中、未命中或绕过信息;
  • Date:响应生成时间;
  • Retry-After:限流或维护建议的重试时间。

这些 CDN 标识头并不统一,某些环境会隐藏或改写,不能只凭一个头部下结论。

2. 用一个可恢复的测试 URL演示负缓存

可以选择一个明确用于测试的不存在路径,按如下顺序验证:

  1. 确认源站返回 404;
  2. 第一次访问 CDN,记录 MISS 和响应头;
  3. 第二次访问 CDN,观察是否变为 HIT,Age 是否增加;
  4. 在源站创建同名资源,使源站返回 200;
  5. 在 TTL 未到期时再次访问 CDN;
  6. 执行精确 URL 失效;
  7. 再次访问 CDN,确认是否回源并返回 200;
  8. 删除测试资源,重新观察 404 是否按预期建立。

如果设置 s-maxage=120,在第 4 步后立即访问仍得到 404,并不一定是配置失败,可能只是负缓存仍在有效期内。执行失效后仍返回 404,则需要进一步排查源站发布、失效范围、查询参数、缓存键或多级缓存。

3. 通过时间点判断缓存是否符合预期

例如某个 404 在 10:00:00 首次写入缓存,设置 CDN TTL 为 120 秒:

  • 10:00:30 源站恢复为 200;
  • 10:01:00 访问 CDN,仍可能得到 404;
  • 10:02:00 后首次访问,才应触发重新验证;
  • 如果执行精确失效成功,下一次访问通常应更快看到 200;
  • 如果 10:03:00 仍是 404,应检查是否存在查询变体、地区节点差异或另一个缓存层。

若观察到 Age 持续增长但已经超过设置的 TTL,可能存在以下情况:

  • CDN规则覆盖了源站 s-maxage;
  • stale-if-error 或其他容错策略正在生效;
  • 访问命中了上游缓存或缓存护盾;
  • Age 头被重置或未透传;
  • 实际缓存键与测试 URL不同。

因此,TTL验证应同时比较状态码、时间头、缓存命中头和源站日志,不能仅看页面文字。

4. 分别测试查询参数和不同边缘节点

对于查询缓存,至少测试以下请求:

curl -sS -D - -o /dev/null 'https://cdn.example.com/item?id=1001'
curl -sS -D - -o /dev/null 'https://cdn.example.com/item?id=1002'
curl -sS -D - -o /dev/null 'https://cdn.example.com/item?id=1001&utm_source=test'

如果三个请求的命中状态、Age 或响应内容表现异常,应确认统计参数是否参与缓存键,以及源站是否真正忽略它。

对于面向多个地区的 CDN,还应从不同网络位置发起相同测试。不同节点可能在失效传播、首次回源和分层缓存上存在短暂差异。验证目标不是要求所有节点在同一毫秒内变化,而是确认在服务商承诺或配置预期的时间范围内完成收敛。

七、这些策略的适用限制

1. 不能用公共缓存承载个性化错误

带有用户信息、订单信息、权限判断、签名结果或账户状态的响应,优先使用 private 或 no-store。即使正文只是“无权访问”,也要确认状态是否因用户不同而变化。

如果必须缓存,应把影响结果的维度纳入缓存键,并验证失效和命中逻辑。缓存键设计错误时,短 TTL只能缩短风险持续时间,不能消除内容串用风险。

2. 不能只依赖错误页内容判断状态是否正确

自定义错误页若返回 HTTP 200,监控系统、搜索引擎和客户端可能把它当成成功页面。除非业务明确需要,否则应尽量保留原始 404、403 或 5xx 状态,并通过正文提供友好提示。

同时检查 CDN是否将源站 5xx 改写为 200,以及前端路由是否把不存在的页面统一返回 200。这类问题与“缓存多久”有关,但根源是状态语义不准确。

3. 失效会带来回源峰值

批量清理大量对象后,下一批请求可能同时回源。如果刚好源站处于高负载状态,失效操作可能让原本被缓存吸收的流量突然回到源站。

目录级失效前应评估:

  • 目录内对象数量;
  • 热点 URL 的访问量;
  • 源站并发和带宽;
  • CDN是否支持请求合并;
  • 是否可以采用版本化 URL代替批量清理;
  • 是否需要预热少量核心对象。

4. 回源失败时的旧内容必须有边界

stale-if-error、缓存锁定或故障兜底能提高可用性,但也可能让旧页面继续存在较长时间。适合使用的对象通常是公开、可容忍短暂陈旧的内容;不适合用于账户余额、库存、权限、支付状态和强一致配置。

最终可以用一组可重复的判断来确定时间是否合适:错误结果是否对所有访问者相同,源站恢复后能否接受等待,是否有发布后的自动失效,缓存键是否覆盖查询和身份维度,TTL到期后是否会重新验证,以及失效后是否验证了多个边缘节点。只要把这些条件与 404、403、429、5xx 分别对应起来,就能避免用一个固定数字覆盖所有错误页面。

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

相关推荐