缓存命中率低的根源在于缓存链路被绕过，需逐层验证：查响应头X-Cache-Status识别BYPASS/MISS/EXPIRED/-等状态；分析access日志统计分布；检查proxy_cache_path下文件是否真实写入；排查error日志权限错误；最后精简proxy_cache_key避免参数污染。
缓存命中率低，不是配置“没开”，而是缓存链路中某个环节被悄悄绕过了。必须从请求进来的那一刻起，逐层检查是否真正进入了缓存流程、是否被正确识别、是否成功写入又能否稳定复用。
看响应头：确认单次请求是否走缓存逻辑
在对应 location 中加这行：
add_header X-Cache-Status $upstream_cache_status always;
用 curl -I 或浏览器 Network 面板查看响应头。重点不是只看 HIT，更要关注高频出现的其他状态：
- BYPASS：说明请求被跳过（如带 Cookie、含 Cache-Control: no-cache、请求方法非 GET/HEAD）
- MISS：首次访问或 key 不一致导致无法复用已有缓存
- EXPIRED：缓存存在但已过期，需回源更新——可能 proxy_cache_valid 太短
- -（空值）：proxy_cache 根本未启用，或 proxy_cache_path 名称不匹配
查日志：统计真实分布，定位瓶颈类型
仅看几个请求不够，要把状态落盘分析。在 http 块定义日志格式：
log_format cache_log '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" $upstream_cache_status';
在 location 中启用：
access_log /var/log/nginx/cache.log cache_log;
用命令快速看分布：
awk '{print }' /var/log/nginx/cache.log | sort | uniq -c | sort -nr
若 BYPASS 占比高，说明大量请求被规则拦截；若 MISS 持续不降，说明 key 不稳定或缓存根本没存住。
验缓存文件：确认磁盘是否真实写入
进入 proxy_cache_path 指定目录（如 /var/cache/nginx），执行：
find . -type f | head -20
应看到大量哈希命名的文件。再挑一个用 stat 查修改时间，和最近一次 HIT 请求时间对比，确认是否实时更新。
同时检查 Nginx 错误日志：
grep "cache\|permission\|failed" /var/log/nginx/error.log
常见报错如 "cache file not found"、"Permission denied"，说明路径权限或文件系统挂载有问题。
抠缓存键：key 不收敛是命中率低的主因
默认 $scheme$host$request_uri 容易被无意义参数污染。例如：
- ?utm_source=weibo&t=1678901234 → 同一页面生成多个 key
- $cookie_sessionid 直接进 key → 登录用户间互相污染
- 忽略 $scheme → HTTP 请求命中 HTTPS 缓存
建议按资源类型精简：
- 静态文件：proxy_cache_key "$scheme$host$uri";（忽略 query 和大小写）
- 多语言接口：proxy_cache_key "$scheme$host$request_uri$lang";（只保留影响内容的变量）
- 用 map 提前清洗 args：map $args $clean_args { ~^(.*&)?lang=([^&]+)(&.*)?$ $2; default ""; }
