全部产品

边缘安全加速：按去参数刷新缓存

更新时间：Feb 25, 2026

当用户访问带有查询字符串的URL时，ESA会根据不同的查询字符串生成不同的缓存。当您使用去参数刷新缓存功能时，如果您提交不带参数的URL，所有原始URL与之匹配带参数的缓存资源都会被清除。

适用场景

场景类型	场景说明
文件版本控制	场景描述：您的网站上有大量静态资源（如图像、CSS和JavaScript文件），这些资源的URL带有不同的查询参数，用于版本控制或缓存控制。每次更新这些文件时，您希望确保所有相关缓存立即失效，使用户能够立即获取最新版本。举例：以下为同一个文件的两个不同版本。 `https://www.example.com/assets/style.css?v=1` `https://www.example.com/assets/style.css?v=2` 解决方案：提交不带查询参数的原始URL，例如`https://www.example.com/assets/style.css`，清除该资源所有版本的缓存。
图片处理	场景描述：您的网站可能会生成各种带有查询参数的图片，例如处理后的缩略图、不同尺寸的图像。要确保这些图片在处理后能立即更新并显示给用户，您需要对应地清除缓存。举例：以下为用户查看同一张图片的两个不同尺寸。 `https://www.example.com/images/photo.jpg?size=small` `https://www.example.com/images/photo.jpg?size=medium` 解决方案：提交不带查询参数的原始URL，例如`https://www.example.com/images/photo.jpg`，清除所有通过不同参数生成的缓存。

操作步骤

在ESA控制台选择站点管理，在站点列单击目标站点。
在左侧导航栏，选择缓存 > 刷新缓存。

在刷新缓存页签，配置刷新规则。

刷新类型：选择去参数。

刷新方法：支持标记过期和直接删除两种方法。

刷新方法

说明

标记过期

节点将按以下流程处理：

ESA节点发送携带 If-Modified-Since 请求标头的回源请求；
源站服务器比对文件修改时间；
若文件未修改，源站将返回 304 状态码，ESA节点可以复用已有的缓存文件来响应客户端请求；
若文件已修改，源站将返回 200 状态码，并且返回最新的文件；ESA节点将最新的文件返回给客户端，并且缓存该资源。

直接删除

如果用户请求的内容匹配到了待刷新的资源，ESA节点将会直接回源拉取新资源返回给用户，并重新缓存该资源。

输入方式：支持手动输入和上传文件两种方式。
- 手动输入：在输入框内直接输入不带参数的URL（带参数将会报错），按照每行一个的方式分隔URL，一次最多不超过100个URL。例如：
```
https://www.example.com/cat.jpg
https://www.example.com/image/cat.jpg
```
- 上传文件：如果待刷新的URL数量比较多，那么可以将待刷新URL录入到TXT格式的文件中，然后上传该文件进行批量刷新。按照每行一个的方式分隔URL，TXT文件大小不超过10 MB。

单击提交。
查看刷新进度。
- 提交刷新任务后，您可以在刷新记录页签中查看资源刷新的详细记录和进度。刷新进度为100%，表示刷新任务执行完成。刷新数量多会影响刷新进度，请您耐心等待。
- 如果您是通过上传文件的方式刷新缓存，您可以在文件上传记录页签查看文件执行状态，当执行状态为成功时，表示文件上传成功并开始执行刷新任务，单个文件的刷新状态可以在刷新记录页签中查看。

不同套餐的支持情况

功能项	Entrance	Pro	Premium	Enterprise
每日额度上限	不支持	不支持	不支持	2000次