当您的URL请求中带有queryString或其他可变参数时,资源重新回源,会导致CDN缓存命中率降低。您可以针对可变参数开启参数过滤功能,提升资源的缓存命中率。
背景信息
当您的URL请求中带有queryString时,或当CDN回源到私有读写类型的bucket,URL自动带上OSS私有访问需要的OSSAccessKeyId、Expires和Signature参数时,CDN默认对带有不同queryString的相同URL请求的处理方式不同,缓存也不同。如果queryString发生变化,则资源重新回源,会导致CDN缓存命中率降低。可以通过开启URL的参数过滤功能,提升资源的缓存命中率。
操作步骤
- 登录CDN控制台。
- 在左侧导航栏,单击域名管理。
- 在域名管理页面,单击目标域名对应的管理。
- 在指定域名的左侧导航栏,单击性能优化。
- 配置保留参数和过滤参数。
- 保留参数
- 单击保留参数区域的修改配置。
- 打开过滤参数开关。
- 您可以根据所需配置保留参数。

参数 |
说明 |
过滤参数 |
过滤参数开关。打开过滤参数开关后,资源回源时会去除URL中? 之后的参数,提高文件缓存命中率。
|
保留参数 |
配置需要保留的参数。最多可以配置10个保留参数,用逗号(,)作分隔符 。例如:http://www.abc.com/a.jpg?x ,保留参数配置为x 。
|
保留回源参数 |
保留回源参数开关。打开保留回源参数开关后,资源回源时,保留所有参数。
|
示例说明:
CDN节点向源站发起请求http://www.abc.com/a.jpg?x
,x=1保留。所有类似的请求http://www.abc.com/a.jpg?x
均响应CDN副本http://www.abc.com/a.jpg?x
的内容。
- 单击确定完成配置。
- 过滤参数
- 单击过滤参数区域的修改配置。
- 打开过滤参数开关。
- 您可以根据所需配置忽略参数。

参数 |
说明 |
过滤参数 |
过滤参数开关。打开过滤参数开关后,资源回源时会删除指定参数,剩余参数将不会被删除。 |
忽略参数 |
配置需要忽略的参数。最多可以配置10个忽略参数,用空格作分隔符。例如:http://www.abc.com/a.jpg?x ,忽略参数配置为x 。
|
保留回源参数 |
保留回源参数开关。打开保留回源参数开关后,资源回源时,保留所有参数。
|
示例说明:
CDN节点向源站发起请求http://www.abc.com/a.jpg?x
,x忽略,http://www.abc.com/a.jpg?x
会响应不同参数源站的响应内容。
- 单击确定,完成配置。
- 您可以通过如下方法,验证缓存是否命中。
- 在浏览器Chrome上,按F12。
- 选择Network。
- 查看指定URL的响应头信息中的
X-Cache
字段。
- 如果显示
HIT
,则说明命中CDN节点上的缓存资源。
- 如果显示
MISS
,则说明未命中CDN节点上的缓存资源,直接回源站获取。
在文档使用中是否遇到以下问题
更多建议
匿名提交