排查 nginx location 无限重定向循环,核心是检查 `return`、`rewrite` 和 `proxy_pass` 指令在匹配规则中的执行顺序与返回值。当请求 url 被规则捕获并返回 301/302 状态码时,浏览器会再次发起请求,若新请求仍命中导致重定向的规则且未改变 uri 或终止循环,就会形成死循环。解决的关键在于确保重定向后的 uri 不再匹配原规则,或通过逻辑判断打破闭环。

如何识别导致循环的 return 或 rewrite 规则
定位循环的第一步是查看 Nginx 错误日志中的 client intended to send too large body 或浏览器控制台的重定向计数报错。通常,问题出在 location 块中使用了 return 指令直接返回重定向状态码,或者使用了 rewrite ... last 但重写后的 URI 依然匹配当前 location。例如,如果配置了 location /api { return 301 /api; },请求 /api 会被永久重定向到自身,导致浏览器陷入死循环。排查时需逐行检查 location 块内的跳转逻辑,确认目标 URI 是否与原 URI 相同或最终指向原路径。

server {
listen 80;
server_name example.com;
# 错误示例:导致无限循环
location /old-path {
return 301 /old-path;
}
# 正确示例:重定向到新路径,不再匹配旧规则
location /new-path {
proxy_pass http://backend;
}
}
上述代码中,/old-path 的请求会被 return 指令立即响应为 301,且 Location 头为 /old-path。浏览器收到后再次请求 /old-path,再次命中该 location,从而形成无限循环。修复方法是修改 return 的目标地址,使其指向一个不同的、不再触发重定向的路径,如 /new-path。
proxy_pass 尾部斜杠引发的重定向陷阱
另一种常见的循环来源是 proxy_pass 指令中 URL 尾部斜杠的处理差异。当 location 路径包含 URI 部分(如 location /api/)时,Nginx 会将匹配到的 URI 部分追加到 proxy_pass 的地址后。如果 proxy_pass 地址本身带有尾部斜杠,而后端服务又对不带斜杠的路径执行了 301 重定向,就可能产生复杂的交互行为,甚至在某些配置下导致客户端层面的循环感知。关键在于理解 Nginx 如何将 location 的剩余部分传递给后端。

server {
listen 80;
server_name example.com;
# 场景:后端要求统一使用带斜杠的路径
location /api {
# 注意:这里没有尾部斜杠
proxy_pass http://backend_server;
}
location /api/ {
# 这里有尾部斜杠
proxy_pass http://backend_server/;
}
}
在上述配置中,如果用户请求 /api(无尾部斜杠),它匹配第一个 location。Nginx 将完整 URI /api 发送给后端。如果后端应用(如 Spring Boot 或 Apache)配置了对 /api 的 301 重定向到 /api/,浏览器会跳转到 /api/。此时,/api/ 匹配第二个 location,Nginx 将空字符串(因为 /api/ 完全匹配前缀)追加到 http://backend_server/,即发送 / 给后端。如果后端对根路径也有处理逻辑,流程继续。但如果后端对 /api/ 也返回重定向,或者 Nginx 配置有误导致反复重定向,就会出现问题。排查时,应检查后端服务的重定向配置,并确保 Nginx 的 proxy_pass 设置与后端期望的 URI 格式一致,避免中间环节产生不必要的 301/302。
基于特定输入条件如何验证重定向链路
为了验证重定向链路是否真的形成循环,可以使用 curl 命令模拟请求并观察响应头。通过添加 -I 参数获取头部信息,或使用 -L 参数跟随重定向并限制次数,可以清晰地看到重定向链条。例如,执行 curl -I -L --max-redirs 5 http://example.com/old-path,如果输出显示多次 HTTP/1.1 301 Moved Permanently 且 Location 头不变,则证实了循环的存在。这种方法可以直接针对具体的输入 URL 进行调试,无需重启服务或修改配置即可快速定位问题节点。











