明确指定 proxy_cache_key 可避免缓存污染，需根据业务包含必要参数、排除干扰参数（如_t、utm_），谨慎引入请求头或Cookie，并通过日志或响应头验证key是否生效。
在 macOS 下使用 Nginx 做反向代理并启用缓存（proxy_cache）时，proxy_cache_key 决定了哪些请求会被视为“相同”，从而复用缓存。默认值通常只包含 $scheme$proxy_host$request_uri，但若后端依赖 URL 参数（如 ?v=1.2.3、?t=1712345678）或请求头（如 User-Agent、Accept-Language），不显式控制 proxy_cache_key 就容易导致缓存污染或命中不准。
明确指定 proxy_cache_key，避免默认行为误判
Nginx 默认的 proxy_cache_key 不包含查询参数（$args）、请求头或 Cookie，这意味着：
-
/api/data?version=1和/api/data?version=2可能被当成同一个 key 缓存，返回错误版本 -
GET /page.html和带Cookie: user_id=123的请求可能共用缓存，造成用户内容错乱
建议根据业务语义显式构造 key。例如，仅对静态资源忽略参数，而对 API 请求严格区分参数：
proxy_cache_key "$scheme://$host$request_uri$is_args$args";
这样就保留了完整 URL（含参数），确保不同参数触发独立缓存项。
按需排除干扰参数，减少缓存碎片
有些参数是前端埋点或防缓存用的（如 ?_t=123456789、?utm_source=xxx），它们不影响后端响应内容，却会导致大量无效缓存键。可在 location 块中先清理再参与 key 构造：
set $args_without_tracking "";
if ($args ~* "^(.*)(?:&|\?)_t=[^&]*(&?.*)$") {
set $args_without_tracking "$1$2";
}
if ($args_without_tracking = "") {
set $args_without_tracking $args;
}
proxy_cache_key "$scheme://$host$request_uri$is_args$args_without_tracking";
更稳妥的方式是用 map 指令预处理（推荐放在 http 块）：
map $args $clean_args {
~^(.*)(?:&|\?)_t=[^&]*(?:&(.*)|$) $1$2;
~^(.*)(?:&|\?)utm_[^&]*(?:&(.*)|$) $1$2;
default $args;
}
proxy_cache_key "$scheme://$host$request_uri$is_args$clean_args";
区分用户上下文：谨慎引入请求头或 Cookie
若需按用户身份缓存（如登录态页面），可加入 $http_cookie 或特定 header：
proxy_cache_key "$scheme://$host$request_uri$is_args$args $http_accept_language $cookie_session_id";
但注意：
- $http_x_forwarded_for 等不可信 header 不宜直接用于 key，易被伪造
- $cookie_* 要确认其稳定性和敏感性，避免因 Cookie 变化频繁导致缓存失效
- 含 Cookie 的缓存必须配 proxy_cache_valid 200 302 10m; 并设置合理过期，防止 stale 数据滞留
验证与调试 cache key 是否生效
macOS 上调试 Nginx 缓存最直接的方式是开启日志记录实际生成的 key：
log_format cache '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'cache: $upstream_cache_status '
'key: "$scheme://$host$request_uri$is_args$args"';
配合 access_log /usr/local/var/log/nginx/cache.log cache;，发起不同参数请求后查看日志中 key 字段是否符合预期。也可用 curl -I 观察 X-Cache 或 X-Proxy-Cache-Key（需在响应头中显式添加）辅助判断。
