Nginx 如何在 Location 块中使用基础的 Rewrite 规则实现简单的 URL 重写

Nginx location 中 rewrite 重写需注意匹配顺序、作用域及 flag 选择：rewrite 必须置于 location 或 server 块内，基本格式为 rewrite 正则 替换目标 [flag]；last 重新匹配 location，break 终止处理，redirect 返回 302，permanent 返回 301；避免循环需精确正则、限定 location 范围并慎用 last。

Nginx 的 location 块中使用 rewrite 实现 URL 重写，关键在于理解匹配顺序、作用域和重写标志。基础用法不复杂，但容易因位置或标志误用导致跳转失败或循环重定向。

rewrite 指令的基本语法和位置要求

rewrite 必须写在 location 块内部（或 server 块顶层），不能放在 if 块里（除非必要且明确知道风险）。基本格式为：

rewrite 正则表达式 替换目标 [flag];

例如：

rewrite ^/old-page$ /new-page permanent;

说明：匹配以 /old-page 精确结尾的请求，301 重定向到 /new-page。注意正则开头的 ^ 和结尾的 $ 表示严格匹配，避免误中 /old-page-2 这类路径。

常用 flag 及其实际影响

flag 决定重写后的行为，选错会导致 404 或无限循环：

1. last：停止当前 location 匹配，用新 URI 重新搜索匹配的 location 块（适合内部重写，不暴露给浏览器）
2. break：停止 rewrite 处理，不再执行后续 rewrite，也不重新匹配 location（适合简单路径替换）
3. redirect：返回 302 临时跳转（浏览器地址栏会变）
4. permanent：返回 301 永久跳转（搜索引擎友好）

例如，想把 /blog/123 改写为 /post?id=123 并内部处理：

location /blog/ {

rewrite ^/blog/(d+)$ /post?id=$1 last;

}

避免 rewrite 循环的几个关键点

循环通常发生在重写后的 URI 又被同一个 location 匹配。预防方法：

1. 用更精确的正则，比如 ^/old/.*$ 而非 /old/（后者会匹配重写后的路径）
2. 把 rewrite 放在专门的 location 块中，让匹配范围最小化
3. 慎用 last —— 如果新 URI 还落在同一 location 范围内，就可能再次触发 rewrite
4. 调试时可加 error_log /path/to/log notice; 查看重写过程

一个实用的静态资源路径迁移例子

把旧的 /static/css/main.css 重写为 /assets/css/main.css，且不改变浏览器地址：

location /static/ {

rewrite ^/static/(.*)$ /assets/$1 break;

}

这里用 break 是因为只是路径映射，不需要再走 location 匹配；正则捕获 (.*) 确保子路径完整保留；/static/ 的斜杠结尾确保只匹配该前缀，不误伤 /static-api 等路径。