Nginx反向代理proxy_pass解码%2F导致400错误的解决方案问询

问题根源 #

Nginx处理请求路径时默认会对转义字符%2F（对应斜杠/）进行自动解码，同时会默认合并连续斜杠，导致转发给后端的路径和原始请求路径不一致，触发400 bad request错误。

具体修改步骤 #

1. 首先在对应server块内添加配置，禁止Nginx自动合并连续斜杠：

server {
    # 原有其他配置保持不变
    merge_slashes off;

    # 原有location、ssl等配置保留
}

2. 修改/api/对应的location块配置，使用原始未解码的请求路径转发：
   将原有的配置：

location /api/ {
  proxy_pass http://backend:3000/;
}

替换为：

location /api/ {
    rewrite ^ $request_uri break;
    proxy_pass http://backend:3000;
}

配置说明 #

• $request_uri是Nginx存储的客户端原始请求路径，完全保留所有转义字符，不会被自动解码
• rewrite指令的break参数会让路径重写后直接在当前location块内执行转发，不会触发新一轮location匹配，避免路径被二次处理
• proxy_pass末尾不能加斜杠或其他路径后缀，否则Nginx会自动替换路径前缀，修改原始请求路径

验证方法 #

修改配置后先执行nginx -t检查配置语法是否正确，确认无报错后执行nginx -s reload重载配置，再测试原请求即可正常转发，不会出现%2F被解码的问题。

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