Nginx 如何在 Nginx 中使用 `break` 标志位完成当前重写并停止后续规则匹配

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 的“可见性”：

1. 它会立即停止当前 location 中后续所有 rewrite 行的执行；
2. URI 已被修改的部分会保留，用于后续处理（比如匹配静态文件或转发）；
3. 它不触发内部重定向（不像 last 那样重新搜索 location），所以不会再次进入 rewrite 流程；
4. 如果写在 if 块里，只对 if 内部的 rewrite 生效，且 if 本身有诸多限制（不推荐滥用）。

break 和 last 的关键区别

这是最容易混淆的点：

1. last：停止当前 location 的 rewrite，然后用新 URI **重新匹配 location**，相当于一次内部重定向；
2. break：停止 rewrite，但**留在当前 location**，直接执行后续指令（如 try_files、proxy_pass）；
3. 例如：rewrite ^/old/(.*) /new/$1 break; → URI 变成 /new/xxx，Nginx 就拿着这个 URI 在当前 location 里继续找文件或转发，不会重新选 location。

典型使用场景与写法

常见于需要“改写路径后就地处理”的情况，比如静态资源重映射或 API 路径前缀调整：

1. 静态资源路径修正：

   location /static/ {
   rewrite ^/static/(.*)$ /assets/$1 break;
   alias /var/www/app/assets/;
   }

   → 把 /static/js/app.js 改为 /assets/js/app.js，然后用 alias 定位到对应磁盘路径。

2. API 路径剥离前缀：

   location /api/ {
   rewrite ^/api/(.*)$ /$1 break;
   proxy_pass http://backend;
   }

   → 请求 /api/v1/users 被改写为 /v1/users，再透传给后端，且不重新匹配 location。

注意事项和常见误区

break 看似简单，但几个细节容易出错：

1. 不能在 server 级直接用 rewrite + break 处理跨 location 逻辑——它只在 location 内生效；
2. 避免和 if 嵌套滥用：if ($args ~ "debug") { rewrite ... break; } 在某些版本可能行为异常，优先考虑 map 或更清晰的结构；
3. 调试时可用 error_log notice; 配合 rewrite_log on;（需编译时启用 debug 日志）观察 rewrite 是否被 break 截断；
4. 如果希望彻底终止并返回，应配合 return 或 rewrite ... last; + 匹配空 location，而不是依赖 break。