缓存刷新不生效的排查指南 #

当您提交了刷新任务后，如果发现浏览器访问到的内容仍然没有更新，可以按照以下步骤进行排查：

1. 检查 CNAME 解析状态（最常见原因）：
   • 核对域名的 CNAME 解析是否正确指向了火山引擎 CDN。 很多时候是因为您的域名流量被切到了其他云厂商，或者回到了源站，此时在火山引擎控制台提交刷新自然不会生效。请使用 ping 或 dig 命令检查您的域名 CNAME 解析值。
2. 检查任务执行状态：
   • 登录控制台，进入 刷新预热 > 操作记录，确认您提交的刷新任务状态是否显示为 成功。
3. 检查缓存键（Cache Key）配置：
   • 确认您的 URL 中是否包含查询参数（如 ?version=1），并检查 CDN 的 缓存键值 配置是否保留了这些参数。如果缓存键中包含了某些您未刷新的参数，您访问带参数的 URL 时可能仍然命中旧缓存。
4. 检查源站文件是否已更新：
   • 直接通过源站 IP 访问该文件，或者检查源站对象的 Last-Modified 或 ETag 头部，确保源站的文件确实已经被替换或更新。
5. 排查浏览器本地缓存：
   • 如果以上均无问题，可能是您浏览器的本地缓存未过期。请尝试在浏览器中使用强制刷新（Ctrl+F5 / Cmd+Shift+R）或者开启无痕/隐私模式进行访问测试。

如何对泛域名下的文件和目录执行刷新、预热、封禁和解封操作 #

您无法直接对一个泛域名下的文件和目录进行刷新、预热、封禁和解封操作。您需要对每个子域名进行这些操作。

例如，加速域名列表中有 www.example.com、img.example.com、doc.example.com。您希望对这些域名下路径是 /file/1.txt 的文件执行刷新操作。在这个情况下，即使列表中还有 *.example.com，您也不能指定刷新的 URL 为 *.example.com/file/1.txt，而是为每个加速域名指定刷新 URL，如下：

www.example.com/file/1.txt
img.example.com/file/1.txt
doc.example.com/file/1.txt

如何对包含签名参数的 URL 进行刷新和预热 #

如果您配置的 URL 鉴权类型是 A，B，C 或 D，CDN 不会在缓存文件的缓存键中包含签名参数。因此，无论您提交的 URL 是否包含签名参数，刷新或预热操作的目标是不包含签名参数的 URL。

如果您配置的 URL 鉴权类型是 E 或者使用的是由火山引擎技术支持人员提供的一个复杂鉴权配置，缓存文件的缓存键会默认包含签名参数。因此，您提交的 URL 必须包含签名参数才能确保刷新和预热操作符合预期。如果您不希望缓存键包含签名参数，参考 缓存键值 做相应缓存键配置。

CDN 支持限制预热时的数据传输速度吗 #

不支持。但是您可以在创建预热任务时，限制该任务的回源请求并发数，降低源站压力。默认的并发数是 10。具体可参考 文件预热。

CDN 支持目录预热吗 #

不支持。如果您输入的预热 URL 是 https://www.a.test.com/，表示对首页进行预热。

预热操作是将资源缓存到所有 CDN 节点吗 #

不是。为了降低源站压力和保障回源请求的效率，CDN 采用的是双层缓存架构。该架构包含边缘层和回源层。边缘层靠近用户，回源层靠近源站。回源层的节点数量相对边缘层少，但是缓存容量更大。预热操作是将资源缓存到回源层。

是否需要分别对 HTTP 和 HTTPS 协议的 URL 刷新和预热 #

不需要。CDN 在缓存资源时是不区分协议的。也就是说，缓存键中不包含请求的协议部分。在指定需要刷新或预热的 URL 时，您可以指定 HTTP 或 HTTPS。

是否支持对包含中文的 URL 进行刷新和预热 #

支持。CDN 会先将 URL 进行编码，然后再执行刷新和预热任务。