在 nginx 中,`rewrite` 指令在 `location` 块内生效的关键在于理解其作用域和返回码。默认情况下,`rewrite` 会立即触发内部重定向,若未指定返回码(如 `last` 或 `break`),nginx 会尝试重新匹配所有 location,可能导致死循环或意外跳转。正确的做法是明确指定 `last` 以重启匹配流程,或 `break` 以终止当前 location 内的重写并继续执行后续指令。

如何避免 rewrite 导致死循环
当 `rewrite` 规则将请求重定向到自身所在的 location 时,若不控制匹配流程,Nginx 会陷入无限循环。解决此问题的核心是使用 `last` 标记,它告诉 Nginx 停止当前 location 的处理,并根据新 URL 重新选择最匹配的 location 块。例如,将 `/old` 重写为 `/new`,使用 `last` 后,Nginx 会再次检查 location 配置,找到 `/new` 对应的处理逻辑,从而避免回到原 location。

server {
listen 80;
server_name example.com;
location /old {
# 将 /old 重写为 /new,并使用 last 重启匹配
rewrite ^/old$ /new last;
# 如果未命中 rewrite,继续执行此处代码
return 404 "Not Found";
}
location /new {
# 处理 /new 的逻辑
return 200 "New Content";
}
}
上述配置中,访问 `/old` 时,`rewrite` 指令将其转换为 `/new` 并设置 `last` 标志。Nginx 随后重新进行 location 匹配,成功定位到 `/new` 块,返回 "New Content"。若去掉 `last`,Nginx 会继续执行 `/old` 块中的 `return 404`,导致无法到达 `/new` 的逻辑。
何时使用 break 替代 last
`break` 与 `last` 的区别在于是否重启 location 匹配。`break` 仅在当前 location 块内生效,重写后的 URL 不会触发新的 location 匹配,而是直接在当前上下文中继续执行后续指令。适用于需要将 URL 映射到文件系统路径,但不需要改变 location 结构的场景。例如,将 `/app` 下的请求重写为静态文件路径,使用 `break` 可避免不必要的匹配开销。

server {
listen 80;
server_name example.com;
location /app {
# 将 /app/test 重写为 /static/test.html,不重启匹配
rewrite ^/app/(.*)$ /static/$1.html break;
# 继续执行 try_files,查找重写后的路径
try_files $uri $uri/ =404;
}
location /static {
root /var/www/html;
}
}
在此配置中,访问 `/app/test` 时,`rewrite` 将其转换为 `/static/test.html` 并设置 `break`。Nginx 不再重新匹配 location,而是继续在 `/app` 块中执行 `try_files`,最终在 `/var/www/html/static/test.html` 查找文件。若使用 `last`,Nginx 会重新匹配 location,可能进入 `/static` 块,导致行为差异。
rewrite 在 location 中的优先级与冲突处理
在 `location` 块中使用 `rewrite` 时,需注意其与 `return`、`proxy_pass` 等指令的执行顺序。`rewrite` 优先于这些指令执行,但若重写后的 URL 仍留在当前 location,后续指令将基于新 URL 运行。若存在多个 `rewrite` 规则,按从上到下顺序执行,第一个匹配的规则生效。为避免冲突,应确保规则互斥,或使用 `if` 条件限制适用范围。例如,区分动态请求和静态资源,分别应用不同的重写策略。


















