首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >EdgeOne 刷新成功仍可能回旧文件:标记过期、编码与缓存键

EdgeOne 刷新成功仍可能回旧文件:标记过期、编码与缓存键

原创
作者头像
一只特立独行的兔先生
发布于 2026-11-22 15:09:51
发布于 2026-11-22 15:09:51
290
举报

源站文件已经换过,CreatePurgeTask 也返回了 JobId,用户仍可能拿到旧内容。EdgeOne 的节点缓存和清除任务不是同一条时间线:没配缓存头的静态文件默认会进节点,清除分成直接删除和标记过期,缓存键对不上时刷新打在另一份副本上。

没配缓存头也会进节点

缓存规则只在源站响应 200、206 时按规则生效。404 固定缓存 10 秒,其它状态码不缓存。错误页如果以 200 返回,会按成功响应进入缓存;真正的 5xx 反而不留。

规则引擎按从上到下的优先级匹配,最上方规则优先级最高。命中后按该规则缓存;都未命中,才落到站点的全局节点缓存策略。全局默认是 EdgeOne 默认缓存策略,不是不缓存。

默认策略看响应头。出现 Cache-Control: private、no-store、no-cache 任一,节点不缓存。这里的 no-cache 被当成不存储,而不是 HTTP 里「可以存、用前必须回源校验」。出现 s-maxage、max-age、Expires 时,缓存时间按这个顺序取,只改 max-age 挡不住已经写上的 s-maxage。

这些头部都没有时:

  • 有 Last-Modified:缓存时间等于当前时间减去 Last-Modified,再乘 0.1,结果夹在 10 秒到 3600 秒。小于 10 秒按 10 秒,大于 3600 秒按 3600 秒。
  • 没有 Last-Modified:按后缀。php、aspx、json 等动态后缀不缓存;html、js、css、图片、音视频,以及文档、压缩包、安装包,缓存 2 小时;名单以外的后缀不缓存。

规则引擎没有单独命中时,前端构建产物不带缓存头,入口 HTML 和脚本默认能在节点上停 2 小时。接口路径只要带了 max-age,即使后缀是 json,也按头部缓存。

自定义缓存时间默认关闭强制缓存。关闭时,源站带了 no-cache、no-store、private 仍不缓存;没带这些头,就按平台填的时间存,不再回落到源站的 max-age。打开强制缓存后,这些头部全部失效。文件长时间没人访问,也可能在 TTL 前被冷热淘汰删掉。这只说明过期前不一定还在,不能用来保证用户看不到旧文件。

TTL 短于 5 分钟时,官方建议不要用清除工具,等超时更新。单次提交上限是 URL 5000 条、目录 1000 条、Hostname 1000 个、Cache-Tag 100 个。数量上去之后,FAQ 的生效时间会从通常 1 分钟内变成 3 到 5 分钟。日配额随套餐变化,超限返回 LimitExceeded.DailyQuota,数字以套餐文档为准。

直接删除和标记过期

URL 刷新和 Cache-Tag 刷新默认直接删除:节点丢掉副本,下一个请求回源拉新文件。目录、Hostname、全部缓存默认标记过期,对应 API 的 Method=invalidate。Method 只对这三类有效,默认就是 invalidate;要直接删除必须显式传 delete。purge_all 不能把 ZoneId 写成 *。

标记过期不先删文件。节点如果缓存了 Last-Modified 和 ETag,下次请求会带 If-Modified-Since 和 If-None-Match 回源。源站回 304,节点继续用旧缓存。源站回 200 时,清除缓存文档写的覆盖条件是:新响应的 Last-Modified 和 Content-Length 至少一个与旧缓存不同,才覆盖。CreatePurgeTask 的接口说明只写了 200 就更新缓存、304 不更新,没有这层对比。两处不一致。发布按更严的条件准备源站:内容变了必须回 200,并且 Last-Modified 或 Content-Length 至少一个要变。只改 ETag、长度和时间都不变,不满足清除缓存文档里的覆盖条件。这两个头缺失时文档没写怎么覆盖,变更响应里至少带一个会变化的值。

直接删除的代价是回源尖峰。一批 URL 同时删掉,短时间内源站承接全部未命中。目录发布如果源站能对未修改资源回 304、对已修改资源回 200,用默认 invalidate。源站忽略条件请求,或发布后 Last-Modified 不变,标记过期会把旧文件留在节点上,这时才用 delete,并按未命中估算源站容量。

Cache-Tag 只在企业版可用。响应头 Cache-Tag 最大 6 KB,逗号分隔,单个 tag 不超过 128 字符,个数上限 1000,比较时忽略大小写。接口参数表要求类型为 purge_cache_tag 时另填 CacheTag(域名),示例却把 tag 放在 Targets。不要凭一份文档拼生产调用,先用控制台或 API Explorer 打一条确认入参。

刷新打在另一份缓存键上

默认缓存键由客户端请求的 URL 和查询字符串计算,不是回源改写后的地址。回源 URL 改写、访问 URL 重写、回源跟随重定向、回源请求头都不参与缓存键。要清的是浏览器地址栏里的 URL。源站内部路径提交了,节点上的副本还在。

保留查询字符串时,参数顺序不同就是不同的键。?version=1&type=a 和 ?type=a&version=1 各存一份。全部忽略查询字符串才会合成一份。指定保留或忽略部分参数时,剩余参数的顺序仍然参与计算。

编码前和编码后的 URL 分开缓存,要各提交一次。开启图片处理后,请求里的图片处理参数默认进缓存键。Token 鉴权内容不进缓存键,只刷新带 token 的地址,不能当成已经清掉鉴权前的那份。

Hostname 刷新不接受 *.example.com。站点接了泛域名时,全部缓存也不会覆盖该泛域名下的副本,要按具体子域名另交任务。

任务成功和用户看到新文件

返回 JobId 只说明任务已受理。进度用 DescribePurgeTasks 按 job-id 查,Status 为 processing、success、failed、timeout、canceled。时间窗最长 7 天。文档写明 2024-05-30 之后 ZoneId 改为必填,调用时带上。success 之后节点生效仍要时间,FAQ 的量级是通常 1 分钟内,提交量大时 3 到 5 分钟。

有没有生效,看这次响应的 EO-Cache-Status。一次请求只代表打到的那个节点。

值

含义

HIT

命中且未过期。清除还没作用到这个节点,或请求落到了另一份缓存键

MISS

未命中;或已过期且源站回了 200,节点要重新取文件

RefreshHit

已过期,源站回了 304,节点继续用旧缓存

标记过期停在 RefreshHit,就是源站声明内容没变。直接删除后的第一次请求应是 MISS;新响应若可缓存,再请求会变成 HIT。只看第二次的 HIT,区分不了新旧,要比对响应体,或让源站带版本头。浏览器里已有的副本不在清除范围内。验收用新的 GET,不要用已经打开的标签页。FAQ 的判断方式也是 GET 看响应头,不是 HEAD。

代码语言:bash
复制
curl -sS -D - -o /dev/null "https://www.example.com/app/index.html" \
  | tr -d '\r' \
  | awk 'tolower($1) ~ /^eo-cache-status:/ {print}'

目录刷新默认标记过期。确认源站不会在内容变化后更新 Last-Modified 或 Content-Length,再显式删除。请求体如下,Action 为 CreatePurgeTask,Version 为 2022-09-01:

代码语言:json
复制
{
  "ZoneId": "zone-example",
  "Type": "purge_prefix",
  "Method": "delete",
  "Targets": ["https://www.example.com/app/"]
}

URL 刷新固定直接删除,不传 Method。编码前后各一条:

代码语言:json
复制
{
  "ZoneId": "zone-example",
  "Type": "purge_url",
  "Targets": [
    "https://www.example.com/a.png?x-oss-process=image/resize,w_600",
    "https://www.example.com/a.png?x-oss-process=image%2Fresize%2Cw_600"
  ]
}

processing 时不要宣布发布完成。job-id 不支持多值和模糊匹配,Name 和 Values 是 AdvancedFilter 的字段。下面是 DescribePurgeTasks 的请求体:

代码语言:json
复制
{
  "ZoneId": "zone-example",
  "StartTime": "2026-11-22T00:00:00+08:00",
  "EndTime": "2026-11-22T23:59:00+08:00",
  "Filters": [
    {"Name": "job-id", "Values": ["20ga521cpwch"]}
  ]
}

success 之后再抽样。循环只解释打到的节点,不证明全网都已更新:

代码语言:bash
复制
url='https://www.example.com/app/index.html'
for i in 1 2 3 4 5 6; do
  status=$(curl -sS -D - -o /dev/null "$url" | tr -d '\r' \
    | awk 'tolower($1) ~ /^eo-cache-status:/ {print $2}')
  printf '%s %s\n' "$(date +%H:%M:%S)" "${status:-<none>}"
  sleep 20
done

持续 RefreshHit,去查源站是否忽略了条件请求。一直 HIT,先核对 URL 是否和缓存键一致,包括查询串顺序和编码,而不是把同一条刷新再提交一遍。

发布时怎么选

静态资源把内容哈希放进文件名。新 URL 是新缓存键,旧文件留到 TTL 结束,发布窗口不必打清除。入口 HTML 不能改名时,给短 TTL,或在规则引擎里设为不缓存,规则放在列表上方。短于 5 分钟的按 FAQ 等超时。

按用户区分的接口不要靠清除保证正确。默认策略遇到 max-age 就会缓存;自定义时间开了强制缓存,no-store 也挡不住。这类路径显式不缓存。

一批页面必须同时更新、又不能改 URL 时,用目录 invalidate,前提是源站对未修改资源回 304,对已修改资源回 200,且 Last-Modified 或 Content-Length 会变。做不到就 delete,并按未命中回源留容量。全站 purge_all 盖不住泛域名,也盖不住编码前后两份键。

预热不是清除的反向保险。预热按提交的 URL 直接请求,不是跨域请求,源站的 CORS 头可能进不了预热副本。需要跨域时,把 CORS 响应头配在 EdgeOne 上,不要假设预热能带回 Access-Control-Allow-Origin。

检查清单

  • 该 URL 在默认策略下会不会被缓存:后缀、有没有 max-age 或 s-maxage、规则引擎是否强制缓存。
  • 提交的是客户端 URL。编码前后、查询串顺序各一份。回源改写后的路径不算。
  • URL 和 Cache-Tag 是直接删除。目录和 Hostname 看 Method,默认 invalidate。
  • 走标记过期时,变更响应要让 Last-Modified 或 Content-Length 变化,不能一律 304。
  • JobId 和 Status=success 之后,用 GET 看 EO-Cache-Status,并核对响应体。RefreshHit 仍是旧文件。
  • 泛域名按具体子域名另交。TTL 小于 5 分钟的文件不等清除。

参考

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 没配缓存头也会进节点
  • 直接删除和标记过期
  • 刷新打在另一份缓存键上
  • 任务成功和用户看到新文件
  • 发布时怎么选
  • 检查清单
  • 参考
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档