Nginx适配多语言Angular站点后Node API返回405 Method Not Allowed求助

核心问题定位 #

你遇到的405错误由Nginx配置的三个错误点导致：

• /nodeApi 代理块全局加了WebSocket专用的Upgrade、Connection头，普通HTTP请求（POST/GET/PUT等）带这两个头会让Node服务误认为是WebSocket升级请求，拒绝处理普通HTTP方法返回405
• 强制覆盖请求Content-Type为application/json，如果前端身份验证接口用的是表单、FormData等非JSON格式，Node服务会无法解析请求体报错
• 普通前缀匹配的/nodeApi/优先级低于语言前缀的正则匹配，若请求携带/da///en/前缀会被转发到Angular入口，无法到达Node服务

修复后的Nginx配置 #

root /var/www/web/dist;

# 浏览器未指定语言时默认使用丹麦语
if ($accept_language ~ "^$") {
    set $accept_language "da";
}

# 根路径跳转对应语言的Angular入口
rewrite ^/$ /$accept_language permanent;

# 语言前缀下的所有路径都回退到对应语言的Angular入口
location ~ ^/(da|en) {
    try_files $uri /$1/index.html?$args;
}

# 加^~保证接口代理优先级高于语言正则匹配
location ^~ /nodeApi/ {
    proxy_http_version 1.1;
    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_pass http://localhost:4444/nodeApi;

    # 如果nodeApi确实有WebSocket接口，单独加路径匹配配置，不要全局加在整个/nodeApi下
    # 示例：
    # location ^~ /nodeApi/ws {
    #    proxy_set_header Upgrade $http_upgrade;
    #    proxy_set_header Connection "upgrade";
    #    proxy_pass http://localhost:4444/nodeApi/ws;
    # }
}

后续排查步骤 #

如果修改后仍有问题，按顺序排查：

1. 本地直接请求Node服务验证接口本身是否正常：

   curl -X POST http://localhost:4444/nodeApi/你的身份验证接口路径 -d "参数"
   

2. 查看Nginx的access.log确认请求方法、路径是否正确转发，error.log查看是否有其他报错

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