nginx rewrite 最多执行10次循环重写，超限返回500错误，该限制由源码硬编码且不可配置；需通过合理使用last、break、redirect等flag及避免location嵌套匹配来防止触发上限。
Nginx Rewrite 规则本身没有“重写深度”这个配置项，它不支持像某些代理或重试机制那样手动设置递归层数。但你可能实际想问的是：Rewrite 跳转最多能执行多少次？会不会无限循环？如何控制？
答案很明确：Nginx 内部对 rewrite 的执行次数做了硬性限制——最多允许 10 次循环重写，超过即返回 500 Internal Server Error。
这是由 Nginx 源码强制限定的保护机制，不可通过配置修改（截至 2026 年最新稳定版仍如此）。
为什么限制为 10 次？
防止因配置错误（比如 rewrite 规则自身又匹配了新路径，再次触发 rewrite）导致 CPU 占用飙升、请求卡死或服务不可用。例如：
location / {
rewrite ^/(.*)$ /$1/; # 末尾加斜杠
}
若 /test 被重写为 /test/，而 /test/ 又匹配同一条规则，就会形成无限循环——Nginx 在第 11 次时直接中断并报 500。
如何避免触达 10 次上限？
- 使用
break或last明确终止流程 - 避免在同一个 location 中链式 rewrite（尤其不要用
last后又匹配到含 rewrite 的 location） - 用
rewrite_log on;+ 查看 error.log，确认每次 rewrite 的实际走向 - 测试时加简单 return 或 echo（配合调试模块），验证是否意外重复进入
例如安全写法：
location /old-path {
rewrite ^/old-path(.*)$ /new-path$1 permanent; # 301跳转，客户端重发，不计入循环
}
location /api {
rewrite ^/api/v1/(.*)$ /v2/$1 break; # break 终止本 location 内后续 rewrite，也不再查找新 location
}
真正影响“跳转行为”的关键参数是 flag
| flag | 行为说明 |
|---|---|
last |
重写后重新匹配 location，可能再次触发 rewrite（计入总次数） |
break |
重写后停止当前 location 内所有 rewrite，继续执行本 location 剩余指令（不计入新循环） |
redirect |
返回 302，客户端发起新请求（不计入服务器 rewrite 循环） |
permanent |
返回 301，客户端发起新请求（同样不计入） |
所以，控制“深度”的本质，是合理选 flag + 避免 location 嵌套匹配。
不复杂但容易忽略。
