Nginx配置多location部署双Node.js应用时/api路径返回404的故障排查
核心配置问题定位
针对你遇到的/api路径返回404的问题,核心是Nginx配置中存在几处明确的逻辑错误,并非复杂的网络或权限异常:
- 反向代理块中错误使用
try_files指令,这是导致问题的核心原因。你在两个location配置中都加入了try_files $uri $uri/ =404;,这个指令执行优先级远高于proxy_pass,会优先在你配置的本地静态目录/var/www/html下查找对应匹配的文件:- 你观察到根路径可以正常访问,本质不是成功代理到了8081端口的Node应用,而是Nginx在执行try_files时,找到了本地/var/www/html目录下的默认index.html文件直接返回了,全程没有触发代理逻辑。
- 而/api路径在本地静态目录下没有对应匹配的目录或文件,会直接触发=404的返回规则,根本不会把请求转发给3000端口的Node应用。
- 代理路径与后端应用的路由规则不匹配。当前
location /api没有配置结尾斜杠,Nginx会把完整的原始请求路径(包含开头的/api段)直接转发给3000端口的Node应用,如果这个Node应用本身的路由没有内置/api前缀(比如仅配置了根路径下的/list、/detail这类路由),后端自身路由匹配失败也会返回404。 - 部分必要的代理上下文缺失。没有将真实的请求原始URI、客户端IP等信息准确传递给后端,部分Node服务框架识别到异常请求上下文时也会直接返回404。
修正后的可运行配置参考
server { listen 80 default_server; listen [::]:80 default_server; server_name example.com; # 该root目录仅用于存放不需要走代理的公共静态资源 root /var/www/html; index index.html index.htm index.nginx-debian.html; # 处理/api路径的代理规则 location /api/ { # 路径适配说明: # 1. 如果后端Node应用本身需要带/api前缀才能匹配路由,去掉proxy_pass后面的斜杠,即写为 proxy_pass http://localhost:3000; # 2. 如果后端Node应用是纯根路径运行(路由无/api前缀),保留proxy_pass结尾的斜杠,Nginx会自动剥掉请求路径里的/api段再转发 proxy_pass http://localhost:3000/; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; # 传递真实请求上下文给后端 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_cache_bypass $http_upgrade; # 反向代理场景下删除try_files指令,避免优先匹配本地文件直接返回404 } # 处理根路径的代理规则 location / { proxy_pass http://localhost:8081; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection 'upgrade'; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_cache_bypass $http_upgrade; } }
分步排查指引
- 配置修改完成后,先执行
nginx -t校验配置语法是否正确,确认无报错后再重载Nginx服务生效。 - 跳过Nginx直接测试两个Node应用的连通性:分别执行
curl http://localhost:3000和curl http://localhost:8081,确认两个服务已正常启动、端口没有被其他程序占用。 - 根据后端Node应用的实际路由规则,调整
location /api/块的斜杠配置:如果应用本身注册的路由都带/api前缀,就去掉proxy_pass末尾的斜杠;如果应用的路由是纯根路径,就保留斜杠自动剥离前缀。 - 查看Nginx的access.log日志,观察/api请求的返回来源:如果日志显示请求未被转发到后端、直接返回404,说明还是存在本地静态文件优先匹配的逻辑;如果显示请求已转发到后端、但收到后端返回的404,就对应调整前后端的路径匹配规则即可。
内容的提问来源于stack exchange,提问作者Ganesh
相关产品推荐
相关产品推荐

