Next.js重定向循环主因是Nginx未改写Location头，导致绝对URL跳转回后端地址；根本解法是Next.js返回相对路径（如/login），或通过proxy_redirect重写Location头为对外域名，并配合proxy_set_header Host与X-Forwarded-Proto传递真实请求信息。
Next.js 应用在生产环境中常通过 Nginx 反向代理部署，但启用 appRouter 的重定向（如 redirect() 或服务端 res.redirect()）时，若 Nginx 配置不当，极易触发重定向循环——浏览器反复 302 跳转，最终报 ERR_TOO_MANY_REDIRECTS。核心问题在于：Next.js 返回的 Location 响应头常含绝对 URL（如 https://example.com/login），而 Nginx 默认不改写该头，导致客户端跳转到原始后端地址（如 http://127.0.0.1:3000/login），再经代理又绕回，形成闭环。
确保 Next.js 返回相对重定向路径
最根本的解法是让 Next.js 尽量返回相对路径（如 /login）而非绝对 URL。这可通过以下方式实现：
- 使用
redirect("/login", RedirectType.replace)（App Router）或res.redirect("/login")（Pages Router），避免手动拼接完整域名 - 禁用
next.config.js中的trailingSlash: true（它可能影响重定向路径生成） - 若必须依赖绝对 URL（如跨子域跳转），则需在 Nginx 层主动修正
Location头——此时proxy_redirect就成为关键工具
正确配置 proxy_redirect 重写 Location 头
proxy_redirect 指令用于修改后端响应中 Location 和 Refresh 头的值。典型场景是将后端返回的 http://localhost:3000/... 替换为对外暴露的域名。
假设你的 Next.js 服务监听 127.0.0.1:3000，Nginx 对外提供 https://myapp.com，则应在 location 块中添加：
proxy_redirect http://localhost:3000/ https://myapp.com/;
proxy_redirect https://localhost:3000/ https://myapp.com/;
⚠️ 注意：proxy_redirect 必须写在 proxy_pass 后面，且匹配规则区分协议、主机和端口；若 Next.js 运行在 HTTPS 下（如本地开发启用了自签名证书），也需对应添加 https://... 规则。
补充关键配置防循环与提升兼容性
仅靠 proxy_redirect 不足以杜绝所有重定向问题，还需配合以下设置：
-
传递真实 Host 头：
proxy_set_header Host $host;（确保 Next.js 生成的绝对 URL 使用正确域名） -
转发协议信息：
proxy_set_header X-Forwarded-Proto $scheme;，并在 Next.js 中通过headers()或getServerSideProps判断是否为 HTTPS，避免混合内容或协议误判 -
关闭缓存干扰：临时调试时可加
proxy_cache_bypass $http_upgrade;和proxy_no_cache $http_upgrade;，防止旧重定向被缓存 -
验证响应头：用
curl -I https://myapp.com/some-route检查Location是否已变为预期的外部 URL
调试重定向循环的实用技巧
当仍出现循环时，快速定位方法如下：
- 在 Nginx 配置中临时开启
error_log /var/log/nginx/nextjs-debug.log notice;，并添加log_format debug '$remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$sent_http_location"'; - 查看日志中
$sent_http_location字段，确认每次跳转的目标是否在myapp.com与localhost之间来回切换 - 用浏览器开发者工具 → Network 标签，追踪全部 302 请求链路，观察
Location值变化 - 在 Next.js 中打印
req.headers.host和req.headers['x-forwarded-proto']，确认服务端感知的入口是否正确
