如何排查 Nginx proxy_pass 代理路径无限重定向
nginx proxy_pass 出现无限重定向通常是因为后端服务返回了包含主机名的绝对 url，而 nginx 未正确剥离或重写请求 uri，导致客户端循环跳转。排查的核心在于检查后端响应头中的 location 字段是否与当前请求匹配，并确认 proxy_pass 指令末尾是否遗漏了斜杠，从而引发路径拼接错误。
为什么 proxy_pass 末尾缺少斜杠会导致路径异常
当 proxy_pass 指令的 URL 末尾没有斜杠时，Nginx 会将客户端请求的 URI 完整传递给后端，包括路径部分。如果后端应用基于前缀进行路由判断，这种完整的 URI 传递可能导致后端生成错误的重定向地址，进而触发 Nginx 再次拦截并重写，形成死循环。通过添加尾随斜杠，可以强制 Nginx 将请求映射到特定的根路径，避免路径片段被错误拼接。
server {
listen 80;
server_name example.com;
# 错误配置：缺少尾部斜杠
location /api/ {
proxy_pass http://backend_server;
}
# 正确配置：添加尾部斜杠
location /api/ {
proxy_pass http://backend_server/;
}
}
如何处理后端返回的 Location 头部导致的循环
即使路径配置正确，如果后端应用（如 Java Spring Boot 或 Node.js Express）在内部重定向时使用了绝对 URL（例如 http://localhost:8080/login），而客户端访问的是域名，Nginx 会忠实地将后端返回的 Location 头发送给客户端。如果该地址不可达或指向自身，就会造成重定向。解决此问题需要在 Nginx 中配置 proxy_redirect 指令，将后端返回的内部地址替换为客户端可访问的外部地址，或者在后端应用中配置正确的 server.name 和协议信息。
server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_server/;
# 将后端返回的 localhost 重定向替换为当前域名
proxy_redirect http://localhost:8080/ http://example.com/api/;
}
}
如何验证 proxy_redirect 是否生效
为了验证 proxy_redirect 是否解决了重定向问题，可以使用 curl -I 命令发送请求并观察响应头。如果后端原本返回 Location: http://localhost:8080/new-path，而在 Nginx 配置了相应的 proxy_redirect 后，响应头应显示 Location: http://example.com/api/new-path。此外，可以通过浏览器开发者工具的 Network 面板查看重定向链，确保不再出现连续的 3xx 状态码循环。若发现仍有循环，需检查后端是否还有其他逻辑生成了绝对 URL，并确保所有相关路径都在 proxy_redirect 中被正确处理。
