nginx在location匹配阶段即截停请求，未进入proxy_pass转发：正则匹配优先级高于前缀，若命中无proxy_pass的location块（如静态资源规则），则默认尝试本地文件服务导致404；需用^~确保前缀匹配终止正则检查，并注意proxy_pass末尾斜杠决定uri拼接方式。
这不是后端没响应，而是请求根本没走到后端——Nginx 在 location 匹配阶段就“截停”了。关键要明白：只要某个 location 块被命中，且内部没有 proxy_pass、fastcgi_pass 或 root/alias 等指令明确指定处理方式，Nginx 就会按默认行为尝试本地文件服务（返回 404）或直接拒绝（返回 500），根本不会往下转发。
检查是否被正则 location 意外拦截
这是最常见原因。比如你写了：
location ~ \.(js|css|png|jpg)$ { expires 1y; }- 而同时又有
location /api/ { proxy_pass http://backend; }
这时访问 /api/v1/data.js 会先匹配正则规则（因为正则优先级高于普通前缀），但该块里没写 proxy_pass，Nginx 就去 root 目录找这个 JS 文件——显然不存在，直接 404。它压根没机会进 /api/ 那个代理块。
确认 proxy_pass 是否被同级 location 覆盖
注意 location 的书写顺序和修饰符影响实际生效顺序：
- 如果
location / { proxy_pass http://backend; }写在最前面，后面又加了location ~ \.js$，那 JS 请求仍会被后者捕获 - 若想让
/api/下所有请求（含静态资源）都走代理，应改用location ^~ /api/——^~表示一旦匹配前缀，立即终止后续正则检查 - 避免在代理 location 内部混用
root或alias，这会让 Nginx 放弃转发，转而尝试读本地文件
验证请求路径是否被 location 重写或截断
proxy_pass 的末尾斜杠决定路径如何拼接：
-
location /prod-api/ { proxy_pass http://127.0.0.1:8080/; }→ 请求/prod-api/user.js转发为http://127.0.0.1:8080/user.js -
location /prod-api/ { proxy_pass http://127.0.0.1:8080; }→ 同样请求会变成http://127.0.0.1:8080/prod-api/user.js，后端若没挂载该路径，就 404 - 查看 Nginx access_log，确认日志中记录的 upstream 地址是否符合预期；若日志为空，说明请求连 location 都没进，可能被更靠前的块或 server_name 不匹配拦截了
排除模块干扰与隐式行为
某些启用的模块会在不声明的情况下改变流程：
-
gzip_static on开启后，若请求app.js但服务器只有app.js.gz，Nginx 可能尝试读取压缩版失败后不再回退到原始文件，导致静默 404 - 误在静态 location 中配置了
limit_rate或auth_request，这些指令本身不触发转发，但会中断默认流程，造成无响应 - 检查 error_log，搜索
open() "/path" failed类错误，可快速定位是文件查找失败还是权限问题
