Nginx缓存路径冲突核心在于location匹配顺序与缓存时机协同：优先用^~锁定静态路径防反代截胡，root追加URI、alias替换前缀，防盗链需前置，缓存策略须按资源类型隔离配置。
处理 Nginx 缓存中资源路径匹配的逻辑冲突，核心是理清 location 匹配顺序 与 缓存生效时机 的协同关系。冲突往往不是配置“错”，而是规则之间因优先级、作用域或执行阶段不匹配，导致请求被意外拦截、错误缓存或路径解析失败。
按优先级锁定静态资源路径，防止被反代截胡
常见问题：所有请求（包括 /static/logo.png）都命中了 location / { proxy_pass http://backend; }，静态文件根本没机会被本地服务。
- 用
^~显式声明高优先级前缀，例如：location ^~ /static/ { root /var/www/assets; }
匹配后立即终止正则检查，确保资源不进 proxy_pass - 避免把
location /放在最前面又不加限定——它会成为“默认兜底”，覆盖所有子路径 - 多项目共存时，为每个子路径单独定义，如
location ^~ /admin/static/ { root /opt/admin/dist; }
区分 root 和 alias，避免多级子目录下路径错位
静态资源部署在嵌套目录（如 /h5/static/js/app.abc123.js）时，路径拼接错误直接导致 404。
-
root是“追加”：location /h5/ { root /opt; }+ 请求/h5/static/js/a.js→ 查找/opt/h5/static/js/a.js -
alias是“替换”：location /h5/static/ { alias /opt/h5-dist/; }+ 同样请求 → 查找/opt/h5-dist/js/a.js - 多级映射推荐用
alias；若磁盘结构与 URL 完全对齐，可用root
缓存策略必须与防盗链、内容更新语义对齐
缓存和防盗链本身不冲突，但配置错序会让浏览器或 CDN 长期复用 403 响应，或让带哈希的新资源无法刷新。
- 防盗链逻辑（
valid_referers）必须写在location最前端，早于任何expires或add_header Cache-Control - 对合法资源设长缓存（如
expires 1y），但必须配合ETag或Last-Modified；对拦截返回的 403，强制禁用缓存：if ($invalid_referer) { return 403; add_header Cache-Control "no-store, no-cache"; } - 带构建哈希的 JS/CSS 应启用
immutable：add_header Cache-Control "public, immutable";—— 这能跳过条件请求，提升复用率
隔离配置作用域，避免规则互相覆盖
混用通用正则和业务路径，极易引发越界匹配，比如 location ~ \.js$ 拦截了 /api/v2/data.js 接口。
- 删掉或注释掉全局后缀正则（如
location ~* \.(js|css|png)$），改用前缀+后缀组合，例如：location ^~ /static/ { ... }+location ~* ^/static/.*\.(js|css|png)$ { ... } - HTML 入口文件必须禁用缓存：
location = / { add_header Cache-Control "no-cache"; try_files /index.html =404; } - 不同项目、不同资源类型（图片/字体/JS/CSS/HTML）应分
location独立配置，不共享缓存指令或防盗链规则
