# 

一个图片站的 CDN 命中率长期在 62% 上下，回源带宽一直降不下来。试过的办法包括：过期时间从 2 小时拉到 7 天、同一张图挪目录测试、换源站、节点预热。命中率没怎么动。

真正的原因在 URL 上。前端每个图片地址都拼了一个时间戳参数，形如 **?t=1698xxxxxx**，用途是「图片更新后强制浏览器拿新的」。浏览器确实拿到新的了，CDN 却把每次请求都当成新资源——缓存键里包含这个永远在变的时间戳。

这篇文章把 CDN 缓存键这件事讲清楚。它的规则不多，但默认值跟业务类型绑定，这一点最容易漏。

## 缓存键到底是个什么东西？

腾讯云 CDN 的文档里有一句定义，是理解后面所有配置的前提：

> 腾讯云 CDN 在进行缓存时使用的是 Key-Value 格式进行资源映射，其中的 Key 即缓存键，Value 即资源在 CDN 中的缓存。您可通过缓存键规则配置，只保留对资源内容有影响的参数作为缓存键，将同一个资源的一类请求转化为统一的缓存键并命中同一份缓存，以提升命中率。

拆开看就三件事：**缓存键是 Key，缓存内容是 Value，命中判断比的是 Key 是否完全相同。** 它不看文件内容，不看后缀，也不做任何「大概相同」的判断。

所以只要 Key 里带了一个每次都不同的部分，这份缓存就永远不会被第二次命中。时间戳、随机数、会话 ID、UTM 参数，都属于这一类。

文档给的三个典型场景，正好覆盖了三种取值：

> 这种场景下需要选择「不忽略」，保留URL所有参数及值作为缓存键，分别进行图片内容的缓存，来进行资源区分。

> 这种场景下可选择「保留指定参数」或「忽略指定参数」，指定保留对图片内容有影响的 version 参数作为缓存键，或指定忽略不影响图片内容的 time 参数

> 这种场景下需要选择「全部忽略」，由「？」之前的链接作为缓存键。节点仅缓存一份资源，即使时间戳签名不断变化，通过签名校验后可直接命中缓存。

三个场景的差别只在「参数对内容有没有影响」。有影响就保留，没影响就忽略，判不了就按业务拆规则。

## 为什么默认值会不一样？

这是这批配置里最容易被忽略的一条：**忽略参数不是全局开关，它的默认值由添加域名时选的业务类型决定。**

> 若加速域名选择网页小文件业务类型，默认不开启忽略参数。缓存键规则配置中，全部文件规则的忽略参数同步为「不忽略」。

> 若加速域名选择下载大文件、音视频点播业务类型，默认开启忽略参数。缓存键规则配置中，全部文件规则的忽略参数同步为「全部忽略」。

为什么这样设计，有它的道理：

- **网页小文件**（HTML、CSS、JS、图片）里，参数常是版本号，**?v=2** 和 **?v=3** 确实是两份内容，忽略就会串。
- **下载大文件和音视频点播**里，参数常是签名，**?sign=xxx** 每次都不同但内容同一份，不忽略等于每请求都回源。

我们那次就是这样：域名按「网页小文件」建，默认「不忽略」，前端又把时间戳当刷新手段，两件事凑一起，缓存键成了随机的。

## 四种参数策略，分别该怎么选？

策略有四种，判断标准只有一个：这个参数会不会改变响应内容。

| 策略 | 缓存键 | 适用情形 | 风险 |
| --- | --- | --- | --- |
| 不忽略 | 完整 URL，含全部参数与值 | 参数即内容版本，如 **?v=2** | 任何随机参数都会打穿缓存 |
| 保留指定参数 | 只保留列出的参数 | 有一个版本参数，其余是无用参数 | 漏列的参数会串内容 |
| 忽略指定参数 | 去掉列出的参数 | 无用参数明确且少，如 **utm_source** | 新增参数忘了加，缓存又开始分裂 |
| 全部忽略 | 问号前的路径 | 签名、时间戳鉴权，如音视频 | 参数真的影响内容时，会返回错的内容 |

表里第一行和最后一行要特别警惕，方向相反但后果都重：**第一行是「缓存用不上」，最后一行是「缓存用错了」。** 前者只花钱，后者出事故。

一个折中的写法是按路径分层：静态资源目录用「全部忽略」，接口和页面用「不忽略」。这样两种风险都被限制在各自的范围内。

## 规则多了以后，谁先命中？

缓存键规则可以按文件类型、文件夹、全路径文件配，一个域名最多 20 条：

> 单个域名至多可添加20条缓存键规则（包含默认规则）。

优先级的方向容易记反：

> 多条规则支持调整优先级：底部优先级大于顶部（默认规则不可调整优先级）。

**底部大于顶部。** 这和大部分配置界面「越靠上越优先」的直觉相反，也和防火墙规则相反。线上真遇到过配了三条规则、以为顶部先生效，结果命中底部那条。

默认规则还有两个限制：

> 默认规则仅支持修改忽略参数和忽略大小写配置，不支持修改类型和内容。

那条「全部文件」的默认规则只能改参数策略和大小写，不能改覆盖范围。要按路径细分只能新增规则，并让新规则排在它下面（优先级更高）。

## URL 大小写不一样，算不算同一份缓存？

不算。文档的配置示例写得很具体：

> 因忽略大小写未开启，则无法命中之前缓存的 www.test.com/abc.jpg 资源，请求回源站获取 abc.JPG 图片资源

前一个请求命中的缓存键是 **abc.jpg**（问号前那段，因为开了全部忽略），后一个因大小写不同，是另一份缓存。

风险很具体：**源站对大小写不敏感、访问端大小写不统一时，同一张图会被缓存成多份。** 常见于从别的系统导入的路径、保留原始文件名、手工拼 URL。

能不能开启忽略大小写，取决于平台当前的状态，配之前先在控制台确认这个开关是否可用，再决定要不要依赖它。

## 命中率上不去，按什么顺序查？

别一上来就调过期时间。过期时间影响「多久回源一次」，命中率影响「能不能命中」，排查顺序该反过来。

| 步骤 | 看什么 | 结论 |
| --- | --- | --- |
| 1 | 访问日志里带查询串的请求占比 | 占比高且参数随机，问题在参数策略 |
| 2 | 同一路径出现的参数名分布 | 找出版本参数与噪声参数 |
| 3 | 控制台里域名的业务类型与默认规则 | 确认默认是「不忽略」还是「全部忽略」 |
| 4 | 是否存在多条缓存键规则 | 确认实际命中的是哪一条 |
| 5 | 大小写是否统一 | 不统一会按大小写分裂成多份缓存 |

第一步就能定位大部分问题。用访问日志统计一下带参数的请求有多少：

```bash
# 带查询串的请求占比
awk '{ if ($7 ~ /\?/) q++; n++ } END { printf "带参数 %d / 总请求 %d\n", q, n }' access.log
```

第二步看参数名，哪些是真参数，哪些是噪声：

```bash
# 取出查询串里的参数名，按出现次数排序
grep -o '?[^ "]*' access.log | tr '?' '\n' | tr '&' '\n' \
  | cut -d= -f1 | sort | uniq -c | sort -rn | head -10
```

如果输出里出现了 **t**、**timestamp**、**_**（下划线时间戳）、**_t** 这类名字，而且每个值都不一样，那基本可以确定是它把缓存键打散了。

## 那个时间戳到底该怎么处理？

前端加时间戳防缓存，这个做法本身没错，错的是它被加在了**静态资源域名**上，而这个域名又被当作内容型资源来缓存。

当时我们改成两种做法，按资源类型分开：

**第一种，构建时把版本写进文件名或路径。** 内容变了文件名就变，URL 里不再需要时间戳。这样缓存键稳定，更新也能立刻生效，命中率不受影响。副作用是每次发布都会产生新文件，旧文件要配生命周期清理。

**第二种，需要强制刷新时用刷新接口，不要用参数。** 参数是「让缓存以为这是新资源」，刷新是「告诉缓存这个资源失效了」。前者会持续制造新 Key，后者只处理一次。

还有一个细节：如果确实要在 URL 里带版本，做成**有限集合**（比如 **?v=3**）而不是**无限集合**（时间戳）。有限集合的缓存键数量可控，命中率按版本数做除法；无限集合等于每请求一份缓存。

## 配置前后该核对哪几项？

这批配完，我们又整理了一张表，配缓存键之前逐项过：

| 核对项 | 具体看什么 |
| --- | --- |
| 业务类型 | 建域名时选的是网页小文件、下载大文件还是音视频，它决定了默认值 |
| 参数语义 | 每个参数是内容版本、鉴权签名，还是纯噪声 |
| 路径分层 | 静态资源与动态接口是否用了不同的参数策略 |
| 规则顺序 | 新增的规则是否排在默认规则下方（下方优先级更高） |
| 规则数量 | 是否接近 20 条上限，后续新增还有没有余量 |
| 大小写 | 同一资源的访问路径是否可能大小写不同 |

这套核对流程我整理成了一份配置说明，几个项目之间来回用。说明的骨架是用 AI墨衍 把几次调整的记录归拢成的，具体到每个参数怎么归类，还得对着自己的访问日志一个一个看，因为参数名背后的语义只有业务方清楚。

缓存键配太细命中率低，配太粗会串内容，平衡点不在文档里，在访问日志里。

顺便问一句：你们域名下带查询串的请求，占全部请求的多少？如果超过三成，而参数里还有随机值，那命中率大概已经被它锁死了。


一个图片站的 CDN 命中率长期在 62% 上下，回源带宽一直降不下来。试过的办法包括：过期时间从 2 小时拉到 7 天、同一张图挪目录测试、换源站、节点预热。命中率没怎么动。

缓存命中率卡在 62%，问题在问号后面那几个参数

网络与通信

运维

云计算

图片CDN命中率长期62%？罪魁祸首是URL中每次变化的时间戳参数（如?t=1698xxxxxx），它导致缓存键永远不同，无法命中。调整过期时间或换源站无效，需配置缓存键规则：按业务类型（网页小文件默认不忽略参数，下载/视频默认全部忽略）选择忽略策略，将版本号等有效参数保留，签名时间戳等噪声参数忽略，并按路径分层、注意优先级底部大于顶部，可显著提升命中率。

视频点播

代码解释

防火墙

CDN免费试用


热销域名限时优惠，新客首年免费！


domain

让每一个 Agent，都跑在云上

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

图片CDN命中率长期62%？罪魁祸首是URL中每次变化的时间戳参数（如?t=1698xxxxxx），它导致缓存键永远不同，无法命中。调整过期时间或换源站无效，需配置缓存键规则：按业务类型（网页小文件默认不忽略参数，下载/视频默认全部忽略）选择忽略策略，将版本号等有效参数保留，签名时间戳等噪声参数忽略，并按路径分层、注意...

缓存命中率卡在 62%，问题在问号后面那几个参数-腾讯云开发者社区-腾讯云

缓存命中率卡在 62%，问题在问号后面那几个参数

缓存命中率卡在 62%，问题在问号后面那几个参数

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐