You need to enable JavaScript to run this app. Nginx配置多location部署双Node.js应用时/api路径返回404的故障排查
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 13:06:03