缓存键设计中对GET请求参数排序规范化，核心目标是使语义相同但顺序、编码或冗余字段不同的URL生成一致缓存键；必须排序以避免CDN等因参数顺序不同而误判为不同资源，导致缓存碎片；应跳过signature等鉴权参数，配合CDN忽略无关参数实现双重保障。
缓存键设计中对 GET 请求参数进行排序规范化，核心目标是让语义相同但参数顺序、编码或冗余字段不同的 URL，生成完全一致的缓存键。这不是“可选优化”，而是提升 CDN 和客户端缓存命中率的关键一步。
为什么必须排序？
CDN、浏览器、反向代理（如 Nginx）默认以原始完整 URL（含 query string 字符串）作为缓存键。例如：
https://api.com/list?limit=20&offset=0https://api.com/list?offset=0&limit=20
两者逻辑完全等价，但因参数顺序不同，会被视为两个独立缓存项——造成重复回源、缓存碎片、命中率下降。排序后统一为 ?limit=20&offset=0，就能合并请求、复用缓存。
如何安全实现参数排序规范化
URLSearchParams 本身没有 .sort() 方法，但可通过标准流程实现确定性排序：
- 用
Array.from(searchParams.entries())提取所有键值对 - 按键名（字符串）按 Unicode 码点升序排序：
.sort(([a], [b]) => a.localeCompare(b)) - 用排序后的数组重建
URLSearchParams，再转为字符串 - 注意：只对普通业务参数排序；签名类参数（如
signature、ts、sign）必须跳过，否则会破坏鉴权逻辑
示例函数：
function normalizeQuery(urlString) {
const url = new URL(urlString);
const params = Array.from(url.searchParams.entries())
.filter(([key]) => !['signature', 'sign', 'token', 'ts'].includes(key)); // 跳过敏感参数
params.sort(([a], [b]) => a.localeCompare(b));
url.search = new URLSearchParams(params).toString();
return url.toString();
}
配合 CDN 忽略参数功能效果更佳
前端排序解决“顺序不一致”问题，但无法消除“无关参数干扰”。比如：
?utm_source=email&uid=789&filter=active?uid=789&filter=active&utm_medium=newsletter
这类埋点、用户标识参数与资源内容无关。应在 CDN 层（如 Cloudflare、阿里云全站加速）开启「忽略指定参数」功能，将 utm_*、uid、ref 等字段从缓存键中剔除。前端排序 + CDN 过滤，形成双重保障。
额外注意事项
- 参数值无需解码再编码——
URLSearchParams内部已处理编码一致性 - 避免对空值参数（如
key=）做特殊处理，保持原样参与排序 - 若服务端使用大小写敏感匹配（极少见），前端排序也应保持大小写原貌，不调用
.toLowerCase() - 路径参数（如
/users/123）不参与 query 排序，它属于资源标识，天然影响缓存键
