Nginx内部重定向循环,500怎么修

页面返回500,Nginx错误日志同时出现rewrite or internal redirection cycle,通常表示同一次请求在服务器内部反复改写或转交URI。浏览器可能只发出一次请求,地址栏也没有变化;这与浏览器连续收到301、302的外部跳转循环是两回事。

Nginx会限制单次请求的内部重定向次数,达到上限后停止并返回500。重点是找出哪个入口再次回到原来的处理链,延长超时不会修复这类循环。浏览器提示跳转过多、能看到多条Location时,应转到外部重定向循环排查。

从错误日志中的目标URI往回找

先确认实际处理该域名的Nginx实例和配置,必要时按实际配置路径检查核对。以下是系统安装示例;面板、容器或使用-c、-p参数的环境要使用它实际的程序与参数:

sudo nginx -T
sudo tail -n 100 -- /var/log/nginx/site-a.error.log

在同一故障时间内,记录原请求路径,以及日志里while internally redirecting to后面的URI。然后从该站点配置寻找对应location、try_files、rewrite、index和error_page,不只盯着文件里出现的第一条rewrite。

nginx -t成功只能证明配置检查通过,不能证明每条请求的运行路径都不会循环。完整配置可能含凭据和内部地址,只在受控终端查看;提供排障材料时截取相关规则并脱敏。

先确认兜底入口真的存在

静态单页应用常把未知页面交给index.html。若root指错目录、发布文件不完整,或者入口不可读,请求可能不断回退到一个仍无法处理的入口。先按真实root或alias映射确定文件位置,再只读检查:

sudo stat -- /srv/www/site/index.html
sudo namei -l -- /srv/www/site/index.html

路径是示例,需要替换。stat找不到文件时先查发布目录和文件名大小写;namei用于查看各级目录与链接,读取权限还要结合Nginx工作进程身份、ACL等判断。不要把所有文件递归改成777,也不要在错误目录里随便创建空入口来让报错消失。

以普通静态HTML入口为例,在原站点root正确且没有同名精确location的前提下,可以为入口增加终止规则:

location = /index.html {
    try_files $uri =404;
}

这样入口不存在时会明确返回404,不再由它自己重复回退。真正恢复页面仍需要部署正确的index.html;从500变成404并不代表业务已修复。已有精确location时在原段内核对,不重复追加。这个片段只用于静态HTML,不能拿去替换PHP入口的FastCGI处理,否则可能造成源码暴露。

文件存在,再检查规则怎样绕回起点

循环线索 重点检查
try_files最终目标又进入同一兜底 目标URI是否能被独立处理,是否因路径错误或规则优先级再次落回原入口。
rewrite使用last后再次匹配同一规则 改写后的URI会重新查找location;逐条写出前后URI,确认是否形成闭环。
error_page指向的地址也报错或被重写 错误页是否存在且能独立返回,是否重新进入原来的兜底或重写链。

例如原请求回退到/index.html,该URI重新进入location后又回退到/index.html,就找到了自循环。另一些情况是两个不同URI互相转交。先找出这一小段闭环,不能直接删除整站伪静态或把所有错误都改为200。

rewrite的last会重新选择location,break则停止本组rewrite并继续当前location的后续处理。两者用途不同;只有请求本来就应留在当前处理段时,才考虑相应调整,不能把全文件的last统一替换为break。

PHP站点还要确认最终入口仍进入正确的PHP处理段,SCRIPT_FILENAME指向实际脚本。运行目录在public的项目,入口路径与完整源码目录不同;修正规则时保留原有的敏感文件保护和上传目录执行限制。

只改闭环处,验收原路径和缺失资源

备份目标站点规则和本次涉及的入口文件,安排可回退的维护时间。只修改已定位的目录或规则,使用同一实例检查通过后再重载:

sudo nginx -t && sudo systemctl reload nginx

检查失败就停止,不重启碰运气。之后验证原故障页面、真实存在的静态资源、一个不存在的资源以及正常应用路由;缺失的JS、图片不能被统一伪装成首页HTML。使用CDN时按实际入口核对是否仍缓存旧错误。

确认同一请求不再产生cycle日志,状态和内容也符合应用设计,再测试登录或其他相关功能。若需要回退,恢复本次目标规则或发布文件,检查后重载,保留错误现场,不删除整个网站重建。