Nginx处理含空格URL返回400错误的问题求助

DevOps 小满

2026-5-20

解决Nginx反向代理Node.js时URL含空格返回400错误的问题

我之前也碰到过一模一样的问题！当请求URL里包含空格这类特殊字符时，Nginx默认的配置会把请求判定为非法，直接返回400 Bad Request。你的怀疑完全正确，问题就出在proxy_pass那行的变量使用上。

问题根源

你原来用的$uri$is_args$query_string组合，$uri是Nginx经过内部处理后的请求路径——它会自动去掉或者“清洗”掉URL里的空格这类不符合规范的字符，导致传递给Node.js后端的请求路径是残缺或非法的，后端自然就返回400错误了。

解决方案

直接改用Nginx的$request_uri变量来替代原来的组合，它会完整保留客户端发送的原始请求路径和查询字符串（包括已经编码的%20或者未编码的空格，只要Nginx允许处理）。

修改后的配置片段如下：

server {
    listen 80;
    server_name api.example.com;

    # 可选：如果客户端发送的是未编码的原始空格，需要添加这两行让Nginx接受这类请求
    ignore_invalid_headers off;
    merge_slashes off;

    location / {
        # 关键修改：用$request_uri替代$uri$is_args$query_string
        proxy_pass http://127.0.0.1:3002$request_uri;
        
        # 这些反向代理的基础配置建议保留，避免后端服务出现其他问题
        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;
    }
}