关键在于用^~或=修饰符精准匹配路径：^~锁定代理路径（如location ^~ /api/）终止后续正则匹配，=精确匹配短路径（如location = /health），避免前缀重叠与兜底规则误伤。
要让 Nginx 反向代理规则不被静态文件配置覆盖，关键不是把 proxy_pass 写在前面，而是用对 location 修饰符，切断错误匹配路径。真正生效的不是“谁先写”，而是“谁更准、谁更早截断”。
优先用 ^~ 锁定代理路径，避免正则劫持
普通前缀（如 location /api/）优先级低，一旦配置了全局正则（比如 location ~ \.js$），像 /api/v1/script.js 就会先进入 JS 处理块，跳过代理——这是最常见失守点。
- 把代理路径明确标为
^~：例如location ^~ /api/ { proxy_pass http://backend; } -
^~匹配成功后直接终止，后续所有正则（~或~*）全被跳过，彻底杜绝“被截胡” - 尤其适合 API 前缀、管理后台等需要稳定转发的路径，不依赖顺序，也不怕后面加新正则
精确匹配高频短路径，防兜底规则误伤
像 /health、/favicon.ico、/robots.txt 这类短路径，如果只写 location /health，它实际会匹配 /healthz 或 /health-check，可能意外落入通用 location / 或其他规则中。
- 改用
location = /health { return 200 "ok"; }，只认完全一致的 URI - 这类规则优先级最高，命中即停，不会被任何后续配置干扰
- 既提升响应速度，又避免因路径相似导致的代理失效或 404
静态资源与代理路径分离，避免前缀重叠
当 location /static/ 和 location /api/ 同时存在，而你又写了 location / 作为兜底，Nginx 会按最长前缀选 /static/ 或 /api/；但若漏写 ^~ 或 =，且路径设计有交集（比如 /api/static/），就可能进错块。
- 确保代理路径和静态路径无语义重叠：如用
/backend-api/代替/api/，或统一加版本号/v1/api/ - 静态资源推荐用
^~ /static/+^~ /assets/，代理路径用^~ /api/，全部显式阻断正则阶段 - 不要混用
location /js/和location ~ \.js$：后者永远无效，因为前者已是前缀匹配，且未加^~时仍可能被更长前缀或正则覆盖
兜底规则 location / 要谨慎，尽量不承载核心逻辑
location / 是优先级最低的通用匹配，看似“保底”，实则是隐患高发区。只要上面有任何一条规则能匹配，它就不会触发；但一旦没写好上层规则，它又会接管所有流量，把本该代理的请求当成静态文件去磁盘找，导致 404 或返回错误内容。
- 避免在
location /里写proxy_pass，除非你真要全局代理 - 把它纯粹当作 fallback：配合
try_files $uri $uri/ /index.html;服务单页应用即可 - 核心业务路径（如登录、API、管理页）全部用
=或^~显式声明，不依赖兜底
