解决nginx静态文件缓存不命中，关键在于确保请求真正落到可缓存路径上，需协同优化文件查找逻辑（如try_files、root/alias）、缓存键设计（如精简proxy_cache_key）和响应头控制（如去除cache-control:no-cache、set-cookie）。
解决 Nginx 静态文件路径缓存不命中，关键不是“加缓存”，而是让请求真正落到可缓存的路径上——这涉及 文件查找逻辑、缓存键设计 和 响应头控制 三个层面的协同。单独调大 max_size 或加 expires 往往无效，问题常出在请求还没走到缓存环节，就已在文件匹配或代理跳转阶段被绕过了。
检查 try_files 是否误判路径存在性
很多“不命中”本质是静态文件根本没被 Nginx 找到，直接 fallback 到后端，自然无法进入 proxy_cache 流程。
- 确认 location 块中是否正确使用了
try_files，例如：try_files $uri $uri/ /index.html;—— 若缺少$uri/，访问/css这类无扩展名路径时不会检查目录，直接 404 或穿透 - 注意
root与alias的差异：用alias时，$uri会被截去 location 匹配前缀；用root则是拼接完整路径。配置错误会导致 Nginx 在错误位置查找文件，始终找不到 - 查询参数（如
?v=1.2）不影响try_files查找，但若前端构建将哈希嵌入文件名（如app.a1b2c3.js），而 URL 仍写成app.js?v=a1b2c3，Nginx 就只查app.js，必然 MISS
验证 proxy_cache_key 是否区分真实资源
缓存键相同，不同内容就会互相覆盖；缓存键过度细分，又导致重复缓存、命中率低。
- 默认
proxy_cache_key "$scheme$request_method$host$request_uri"对带 Cookie 或用户标识的请求不友好——只要任意用户带 Cookie 访问，就触发BYPASS，永远不进缓存 - 静态资源应剥离用户上下文：去掉
$cookie_*、避免Vary: *响应头；如需区分登录/游客版，显式加入$arg_theme等可控变量，而非依赖 Cookie - 注意
$request_uri包含查询参数，但多数静态资源无需按参数区分（如logo.png?t=123和logo.png应缓存同一份），可改用$scheme$request_method$host$uri排除 args
排查响应头是否阻止缓存建立
Nginx 不会缓存明确禁止缓存的响应，哪怕配置再完善。
- 后端返回
Cache-Control: no-cache、no-store或private时，proxy_cache 直接跳过缓存，状态为BYPASS - 后端返回
Set-Cookie头，Nginx 默认不缓存（防用户数据混存），需配合proxy_ignore_headers Set-Cookie;才允许缓存（仅适用于无敏感态的静态资源） - 确保后端对静态路径返回标准状态码（200/304），避免返回 206（Partial Content）或 302（重定向）——这些状态默认不在
proxy_cache_valid范围内
用 $upstream_cache_status 日志定位真实原因
别猜，看日志。在 log_format 中加入该变量，再统计分布：
-
HIT：缓存生效，路径和键都正确 -
MISS：首次请求或缓存过期，但说明已进入缓存流程 -
BYPASS：请求被规则拦截（如含 Cookie、非 GET 方法、响应含 no-cache），这是最常被忽略的“伪不命中” -
EXPIRED：缓存存在但过期，需检查proxy_cache_valid设置是否合理 - 用
grep "BYPASS" access.log | awk '{print $7}' | sort | uniq -c快速找出哪些 URI 总被跳过，再针对性清理 Cookie 或调整 proxy_ignore_headers
