Nginx重写功能由ngx_http_rewrite_module模块提供，语法为rewrite<regex><replacement>[flag]；regex用PCRE正则匹配URI，replacement支持$1等捕获组和内置变量，flag含last、break、redirect、permanent等控制行为。
Nginx 的重写（Rewrite）功能主要靠 rewrite 指令和 if、return、location 等配合实现，它本身没有独立的“重写模块”，而是由核心模块 ngx_http_rewrite_module 提供支持——这个模块默认编译进 Nginx，无需额外加载。
rewrite 指令的基本写法和匹配逻辑
rewrite 用于修改请求 URI，语法为：rewrite <正则表达式> <替换目标> [flag];
关键点：
- 正则表达式使用 PCRE，区分大小写（加
i可忽略大小写，如^/old/(.*)$ i） - 替换目标中可用
$1、$2等捕获组，也可用内置变量如$args、$host - 常用 flag：
last（内部重定向，重新匹配 location）、break（停止后续 rewrite，不重新匹配）、redirect（302 临时跳转）、permanent（301 永久跳转）
rewrite 和 if 的配合要谨慎
if 在 server 或 location 块中可用于条件判断，但它的行为有陷阱：
-
if块内只允许有限指令，rewrite是其中之一，但if不是推荐的路由控制方式 - 避免在
if中用root或rewrite做复杂逻辑，容易引发重复执行或意外交互 - 更稳妥的做法：优先用
location匹配路径，再在其中用rewrite；需要条件时，考虑map指令预定义变量
常见实用场景示例
比如把旧域名跳转到新域名：
if ($host = 'old.example.com') {
return 301 https://new.example.com$request_uri;
}
又如统一移除 URL 尾部斜杠（非目录时）：
rewrite ^/(.*)/$ /$1 permanent;
再如将 PHP 脚本路径伪装成静态路径：
rewrite ^/article/(\d+)\.html$ /article.php?id=$1 last;
注意：这类规则需确保后端能正确接收参数，且不要和 location ~ \.php$ 冲突。
调试 rewrite 规则的关键方法
开启重写日志可直观看到每步执行过程：
- 在 http 或 server 块中加：
rewrite_log on; - 同时确保 error_log 级别为 notice 或 debug：
error_log /var/log/nginx/rewrite.log notice; - 重启 Nginx 后访问测试 URL，查看日志中是否触发、如何替换、是否循环（出现 “rewrite or internal redirection cycle” 表示死循环）
