Nginx 中 rewrite 配合 break 标志仅终止当前 location 内后续 rewrite 指令，重写 URI 后就地处理且不重新匹配 location；它不跳转、不重定向，适用于路径映射等需精确控制路径的场景。
在 Nginx 中，rewrite 指令配合 break 标志，本质是做一次内部 URI 重写后立即终止当前 location 内的后续 rewrite 处理，且不再发起新匹配。它不跳转、不重定向，只改写请求路径并就地处理。
break 的作用机制
break 不是“跳出整个配置”，而是停止当前 location 块中所有剩余的 rewrite 指令执行，并以重写后的 URI 作为最终路径，在当前 location 内继续走后续流程（比如 root、alias、proxy_pass 或静态文件查找）。
- 重写后的 URI 不会再次进入 server 块重新匹配 location —— 这和
last的行为截然不同 - 它只影响 rewrite 模块内部指令流，不影响其他模块（如 if、return、proxy_pass）的执行
- 常用于“路径映射”场景，比如把
/api/v1/xxx改成/v1/xxx后直接交给当前 location 处理
典型用法示例
假设你希望将所有以 /static/ 开头的请求，内部重写为去掉前缀后访问本地文件：
location /static/ {
rewrite ^/static/(.*)$ /$1 break;
root /var/www/html;
}
当请求 /static/css/app.css 时：
- 正则匹配成功，
$1是css/app.css - URI 被重写为
/css/app.css -
break生效 → 不再执行本 location 中其他 rewrite，也不重新匹配 location - Nginx 直接在
/var/www/html下查找/css/app.css（即/var/www/html/css/app.css）
和 last 的关键区别
如果上面例子中把 break 换成 last，行为完全不同：
-
last会让 Nginx 把重写后的 URI（/css/app.css）当作新请求，回到 server 块开头重新匹配 location - 可能匹配到
location /、location ~ \.css$等其他规则，结果不可控 - 而
break锁定在当前 location 内执行，路径控制更明确、更安全
常见误用与注意事项
break 容易被误认为“跳出 location”，但其实它只是停止 rewrite 指令链。以下情况需特别注意：
- 若重写后路径在当前 location 的
root或alias下找不到对应文件，仍会返回 404（不会 fallback 到其他 location） - 不能和
proxy_pass混用时省略break：例如rewrite ^/api/(.*)$ /$1 break;+proxy_pass http://backend;，确保代理的是重写后的路径 - 在
if块中使用rewrite ... break是允许的，但if本身有性能和语义风险，建议优先用try_files或 location 分离替代
