Nginx配置proxy_pass代理时POST请求转为GET问题如何解决？

问题根本原因 #

该问题绝大多数场景是请求触发301/302重定向时，客户端默认将POST请求转为GET请求导致，核心触发点有两个：

1. 你配置的location规则带末尾斜杠，当请求路径不带末尾斜杠时，Nginx会自动返回301重定向到带斜杠的路径，这个过程中POST请求会被转为GET
2. 上游服务返回301/302重定向时，默认也会触发请求方法转换

可行解决方案 #

按优先级依次尝试以下操作即可：

1. 强制透传原始请求方法 #

在所有需要透传请求的location块中添加proxy_method $request_method;配置，强制Nginx转发时完全使用客户端发来的原始请求方法，不做任何修改。

2. 处理路径末尾斜杠的重定向问题 #

两种方案二选一即可：

• 方案A：调用接口时严格匹配location的路径规则，比如location /api/register/对应的调用路径必须是http://你的域名:8080/api/register/xxx，末尾不能少斜杠
• 方案B：修改location匹配规则，去掉末尾斜杠，避免触发Nginx自动重定向。

3. 关闭Nginx对重定向的默认修改 #

添加proxy_redirect off;配置，让Nginx完全透传上游服务返回的重定向响应，不修改重定向地址，也不做额外的跳转处理。

完整配置参考 #

修改后的完整配置如下：

server {
    listen 8080;

    location /api/register/ {
        proxy_pass http://micro_auth_backend:8082;
        # 核心配置：透传原始请求方法
        proxy_method $request_method;
        # 透传完整请求头和请求体
        proxy_pass_request_headers on;
        proxy_pass_request_body on;
        # 不修改上游返回的重定向配置
        proxy_redirect off;
        # 原有请求头配置
        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;
    }

    location /api/location/ {
        proxy_pass http://localhost:8088;
        proxy_method $request_method;
        proxy_pass_request_headers on;
        proxy_pass_request_body on;
        proxy_redirect off;
        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;
    }
}

完成配置后重启Nginx即可生效。

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