生成唯一缓存键的关键是按语义取舍维度：必含$scheme、$request_method、$host、$request_uri；按需添加用户态、终端类型、API版本等因子；主动清洗UTM等干扰参数；须通过日志和curl实测验证。
生成唯一缓存键的关键，是让每个业务上“应返回相同内容”的请求共享一个 key，而“可能返回不同内容”的请求必须有不同 key。这不是变量堆砌，而是按实际语义做取舍和加工。
必须包含的基础维度
缺一不可，否则连协议、域名、路径层面的区分都做不到：
- $scheme：区分 http 和 https，避免混用缓存
- $request_method：GET 和 HEAD 必须分开，POST 一般不缓存；若缓存幂等接口，保留该变量可防止覆盖
- $host：比 $proxy_host 更准确，能区分 api.example.com 和 www.example.com
- $request_uri：含路径和原始查询串，但注意它本身不稳定（如某些 rewrite 后变化），建议配合清洗后的参数使用
按需加入业务差异化因子
是否引入，取决于你的响应是否因这些因素而不同：
-
登录用户态：用
md5($cookie_user_id)替代明文，防泄露且控长度 -
终端类型：优先取
$http_x_requested_with（值为 XMLHttpRequest 或空），比解析 User-Agent 更轻量稳定 -
API 版本或主题：如后端通过
?v=2或X-API-Version区分，可提取为$arg_v或用 map 提前映射 -
多租户或子应用标识：加
$server_name或自定义$app_id，避免共用缓存区时互相干扰
主动清洗干扰参数
UTM、ts、random 等参数不改变响应内容，却会让 key 大量膨胀。不能直接拼 $args，得预处理：
- 在
http块中用map定义清洗逻辑，例如剔除utm_*、ts=、random= - 示例：map $args $clean_args { ~^(.*)(?:&|&)?utm_[^&=]*=[^&]*(&.*)?$ $1$2; default $args; }
- key 中使用清洗后变量：
fastcgi_cache_key "$scheme$request_method$host$request_uri$is_args$clean_args";
验证 key 是否真实生效
配置写完不等于起效，必须实测输出：
- 加日志格式：
log_format cache '$cache_key - $upstream_cache_status';，再启用该 access_log - 用
curl -I观察响应头：X-FastCGI-Cache（需配add_header）和Age字段变化 - 临时设 key 为固定字符串（如
"debug_key"），看多个不同请求是否全部命中 HIT，快速确认配置加载成功
