break 用于终止当前 location 块内后续 rewrite 指令执行，保留已修改 URI 并继续执行该 location 内其他指令（如 proxy_pass、alias），不触发重新 location 匹配。
在 Nginx 中，break 是 rewrite 指令的一个标志位，作用是**终止当前 location 块内的 rewrite 规则匹配，并不再执行后续的 rewrite 指令，但请求会继续向下执行该 location 内的其他配置（如 proxy_pass、root 等）**——它不会跳出 location，也不会发起新的内部重定向。
理解 break 的行为边界
break 只影响当前 location 块中剩余的 rewrite 指令，不改变请求 URI 的“可见性”：
- 它会立即停止当前 location 中后续所有
rewrite行的执行； - URI 已被修改的部分会保留，用于后续处理（比如匹配静态文件或转发）；
- 它不触发内部重定向（不像
last那样重新搜索 location），所以不会再次进入 rewrite 流程； - 如果写在
if块里，只对 if 内部的 rewrite 生效，且 if 本身有诸多限制（不推荐滥用）。
break 和 last 的关键区别
这是最容易混淆的点：
- last：停止当前 location 的 rewrite，然后用新 URI **重新匹配 location**，相当于一次内部重定向；
- break：停止 rewrite，但**留在当前 location**，直接执行后续指令（如 try_files、proxy_pass）；
- 例如：
rewrite ^/old/(.*) /new/$1 break;→ URI 变成/new/xxx，Nginx 就拿着这个 URI 在当前 location 里继续找文件或转发，不会重新选 location。
典型使用场景与写法
常见于需要“改写路径后就地处理”的情况，比如静态资源重映射或 API 路径前缀调整：
-
静态资源路径修正：
location /static/ {<br> rewrite ^/static/(.*)$ /assets/$1 break;<br> alias /var/www/app/assets/;<br> }
→ 把/static/js/app.js改为/assets/js/app.js，然后用 alias 定位到对应磁盘路径。 -
API 路径剥离前缀：
location /api/ {<br> rewrite ^/api/(.*)$ /$1 break;<br> proxy_pass http://backend;<br> }
→ 请求/api/v1/users被改写为/v1/users，再透传给后端，且不重新匹配 location。
注意事项和常见误区
break 看似简单，但几个细节容易出错：
- 不能在
server级直接用 rewrite + break 处理跨 location 逻辑——它只在 location 内生效； - 避免和
if嵌套滥用：if ($args ~ "debug") { rewrite ... break; }在某些版本可能行为异常，优先考虑 map 或更清晰的结构； - 调试时可用
error_log notice;配合rewrite_log on;（需编译时启用 debug 日志）观察 rewrite 是否被 break 截断； - 如果希望彻底终止并返回，应配合
return或rewrite ... last;+ 匹配空 location，而不是依赖 break。
