Node/Express应用直连正常，经Nginx代理后Express返回404错误

可能的问题原因 #

• Nginx路径重写或proxy_pass配置错误
  最常见的情况是proxy_pass末尾的斜杠导致路径被截断。比如你Express路由是/api/submit，Nginx用proxy_pass http://localhost:3000/（带斜杠）的话，请求会被转成http://localhost:3000/submit，但你的路由是/api/submit，自然匹配不上。
• Nginx未正确传递POST请求方法
  有些配置里不小心加了proxy_method GET，或者用limit_except限制了只能用GET，导致POST请求被强制转成GET，而你的Express只有POST路由，直接返回404。
• Express未信任代理，导致路径解析错误
  Express默认不会识别代理过来的请求头，不知道真实的请求路径和协议，路由匹配逻辑会出错。
• 请求路径编码问题
  如果请求里有特殊字符，Nginx可能会错误编码，传到Express那边路径就变了，匹配不到对应的路由。

解决办法 #

1. 修正Nginx的proxy_pass配置 #

根据你的路由结构调整proxy_pass：

• 如果Express路由是带前缀的（比如/api/*），proxy_pass末尾不要加斜杠，保留完整路径：

server {
    listen 80;
    server_name your-domain.com;

    location /api/ {
        proxy_pass http://localhost:3000;
        # 必须加这些头，确保Express能拿到真实请求信息
        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;
    }
}

• 如果需要去掉前缀（比如把域名根路径代理到Express的/api/*），用rewrite指令调整路径：

location / {
    rewrite ^/(.*)$ /api/$1 break;
    proxy_pass http://localhost:3000/;
    # 同样要加上面的proxy_set_header配置
}

2. 确保Nginx允许POST请求 #

检查配置里有没有限制请求方法的代码，如果有limit_except，要包含POST：

location /api/ {
    limit_except GET POST {
        deny all;
    }
    # 其他proxy配置...
}

同时确认没有proxy_method GET这类错误指令。

3. 让Express信任代理 #

在你的Express应用最开头加上：

app.set('trust proxy', true);

这会让Express使用Nginx传递的X-Forwarded-*头来解析真实的请求路径和协议，避免路由匹配错误。

4. 打印请求日志验证路径 #

在Express里加个全局中间件，打印所有请求的方法和路径，看看代理后的请求是不是和直连时一致：

app.use((req, res, next) => {
    console.log(`[${new Date().toISOString()}] ${req.method} ${req.originalUrl}`);
    next();
});

启动应用后，通过Nginx发请求，看日志里的路径是不是你预期的路由路径。

5. 处理路径编码问题 #

如果请求有特殊字符，在Nginx配置里加上这些头，确保原始路径正确传递：

proxy_set_header Accept-Encoding "";
proxy_set_header X-Forwarded-Uri $request_uri;

内容的提问来源于stack exchange，提问作者Michael Search