Nginx proxy_pass移除前缀时出现400错误的问题排查

我来帮你排查这个Nginx代理导致400错误的问题。首先，400错误通常意味着后端收到的请求格式不符合预期，咱们先从你的配置和可能的细节入手分析：

你当前的环境是Docker Compose部署的Nginx、UI和后端服务，直接访问后端http://localhost:8080/heartbeat能拿到200，但通过Nginx代理访问https://localhost/services/heartbeat就返回400，而且UI的代理是正常的，说明Nginx的基础配置没问题，问题出在后端服务的代理规则上。

你之前配置里的几个潜在问题 #

1. 错误的Host头设置：最初的配置里你写了proxy_set_header HOST $host/work;，这会把请求的Host头改成类似me.com/work，后端服务收到这个不符合预期的Host头，很可能直接返回400。虽然你后来改成了$host，但可能还有其他路径匹配的问题。
2. 路径匹配和proxy_pass的斜杠冲突：
   • 你最初用了rewrite /services/(.*) /$1 break;配合proxy_pass http://be:8080;，这个规则本身没问题，但如果请求是/services（不带末尾斜杠），rewrite可能不会生效，导致路径传递错误。
   • 后来你改成proxy_pass http://be:8080/;（加了末尾斜杠），但你的location是/services（不带斜杠），这时候Nginx会把/services/heartbeat转换成//heartbeat（双斜杠），部分后端服务会认为这是无效路径，返回400。

两种正确的配置方案（二选一即可） #

方案一：用rewrite规则移除前缀（适合复杂路径调整）

location /services {
    # 准确匹配/services/开头的路径，把前缀替换掉
    rewrite ^/services/(.*)$ /$1 break;
    proxy_pass http://be:8080;
    # 必要的请求头设置，确保后端能正确识别请求
    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; # 告诉后端请求是http还是https
    # 如果后端不需要WebSocket升级，可以去掉下面两行
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
}

方案二：用Nginx自带的路径映射（更简洁）

# 注意location末尾加斜杠，和proxy_pass的斜杠对应
location /services/ {
    proxy_pass http://be:8080/;
    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_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
}

这个方案里，Nginx会自动把/services/开头的路径替换成/，比如/services/heartbeat会被代理到http://be:8080/heartbeat，避免双斜杠的问题。

额外的排查建议 #

• 查看Nginx错误日志：这是定位问题最快的方式，执行命令进入Nginx容器查看日志：

  docker exec nginx tail -f /var/log/nginx/error.log
  

  日志里会明确告诉你400错误的原因，比如路径无效、请求头错误等。
• 检查后端服务日志：看看后端收到的请求路径、Host头是不是符合预期，比如后端是否期望/heartbeat路径，还是需要其他前缀。
• 验证Nginx配置正确性：修改配置后，先测试配置是否合法，再重载Nginx：

  docker exec nginx nginx -t
  docker exec nginx nginx -s reload
  

备注：内容来源于stack exchange，提问作者Jackie