break的作用是重写uri后立即停在当前location内继续处理，不重新匹配location；它跳过后续rewrite指令，但执行root、alias、proxy_pass等剩余指令，适用于路径映射、代理透传等就地处置场景。
在 Nginx 的 location 块中使用 rewrite ... break，核心作用是：**重写 URI 后立即停在当前 location 内继续处理，不重新匹配 location**。它适合需要“就地处置”的场景，比如路径映射、静态资源重定向、代理路径微调等。
break 的本质行为
break 不会触发新请求流程——它只是把 rewrite 后的 URI 当作当前 location 的新输入路径，直接走完该 location 下剩余指令（如 root、alias、proxy_pass），不再跳出当前 location 去寻找其他匹配块。
- 当前 location 若配置了
root或alias，rewrite + break 后的路径会基于该路径解析文件 - 若配置了
proxy_pass，rewrite 后的 URI 将作为相对路径透传给后端（例如 proxy_pass http://upstream; + rewrite /api/v1/(.*) /v2/$1 break → 后端收到 /v2/xxx） - 后续所有 rewrite 指令都会被跳过，但非 rewrite 指令（如 add_header、echo、try_files）仍会执行
典型适用场景
静态资源路径调整：前端构建输出路径与 Nginx 静态服务目录不一致时，用 break 快速对齐。
location /static/ {
alias /var/www/assets/;
rewrite ^/static/(.*)$ /$1 break;
# 请求 /static/js/app.js → 重写为 /js/app.js → 在 /var/www/assets/ 下查找 js/app.js
}
代理路径裁剪与透传：保留原始请求结构，只改前缀并交给同一后端处理。
location /service/ {
proxy_pass http://backend;
rewrite ^/service/(.*)$ /$1 break;
# /service/api/user → 重写为 /api/user → proxy_pass 透传为 http://backend/api/user
}
避免死循环的内部重写：在非根 location 中做路径归一化，防止 last 触发重复匹配。
location ~ ^/v1/(.*)$ {
rewrite ^/v1/(.*)$ /v2/$1 break;
proxy_pass http://api;
# 若用 last，/v1/xxx 重写为 /v2/xxx 后会重新匹配 location，可能再次进入此块导致循环
}
和 alias 搭配要特别注意
alias 和 break 不能共存——这是常见 404 根源。因为 alias 要求 URI 必须严格匹配 location 前缀，而 break 不改变 location 匹配上下文，重写后的路径若超出 alias 定义范围，就会找不到文件。
- 错误示例：
location /img/ { alias /data/pics/; rewrite ^/img/(.*)$ /thumb/$1 break; }→ 请求 /img/logo.png 重写为 /thumb/logo.png，但 alias 只响应以 /img/ 开头的路径，/thumb/ 不在 alias 范围内 → 404 - 正确做法：要么去掉 alias 改用 root + index，要么改用 last 让重写后路径重新匹配另一个专用于 /thumb/ 的 location
调试技巧
加 log_format 和 $request_uri、$uri 日志字段，对比三者值：
-
$request_uri：原始请求（含 query string） -
$uri：rewrite + break 后、进入 location 处理时的实际路径（已解码，无参数） - 日志里看到
$uri已变但仍在同一 location 块下执行，说明 break 生效
