缓存键设计需剔除无用url参数以避免缓存污染，核心是保留影响内容的参数（如lang、region），剔除追踪类（utm_source、fbclid）和动态干扰类（ts、_t）参数，并在cdn或服务端标准化处理。

缓存键设计中剔除无用 URL 参数，核心是让相同内容的请求生成相同的缓存键，避免因无关参数（如 utm_source、ref、fbclid、timestamp 等）导致同一资源被重复缓存多份，造成缓存污染和存储浪费。

识别并归类无用参数

先梳理业务中所有可能出现的查询参数，按用途分三类：

• 影响内容的参数：如 lang=zh、region=us、version=2——这些必须保留在缓存键中
• 纯追踪/埋点参数：如 utm_medium=email、gclid=ABC123、fbclid=...——不改变响应内容，应剔除
• 干扰性动态参数：如 ts=1726489000、_t=123456、random=0.123456789——常用于防缓存或调试，必须剔除

在 CDN 或边缘网关中配置缓存键规则

主流 CDN（如阿里云DCDN、Cloudflare、Azure Front Door）均支持自定义缓存键。操作要点如下：

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

• 关闭“忽略全部参数”全局开关，改用“保留指定参数”模式
• 只显式列出需参与缓存键的参数名，例如：lang,region,format,version
• 未列出的参数一律不参与缓存键计算，无论是否存在
• 注意大小写敏感性：确保参数名拼写与实际请求一致（如 Lang 和 lang 被视为不同参数）

服务端配合：统一参数标准化入口

仅靠边缘层过滤不够稳健，建议后端增加轻量级预处理：

• 在反向代理（如 Nginx）或网关层，用 rewrite 规则移除已知无用参数，再转发给源站
• 源站接收请求前，对 query string 做 normalize：排序参数名、小写化、剔除黑名单参数
• 若使用 Node.js / Express，可用中间件统一处理：
  const uselessParams = ['utm_source', 'fbclid', 'gclid', 'ref', 'ts', '_t'];
  req.query = Object.fromEntries(
    Object.entries(req.query).filter(([k]) => !uselessParams.includes(k))
  );

验证与监控关键点

上线后需确认剔除逻辑生效且不误伤：

• 用 curl 模拟带/不带无用参数的请求，比对响应头中的 X-Cache: HIT 是否命中同一缓存项
• 检查 CDN 日志或缓存统计报表，观察相同路径下不同参数组合的缓存键数量是否明显下降
• 对关键资源做 A/B 请求测试：如 /api/user?id=123&utm_campaign=newsletter 和 /api/user?id=123&ref=blog 应返回完全一致的 ETag 或 Last-Modified