一、Rewrite模块基础架构解析

Nginx的Rewrite功能由ngx_http_rewrite_module模块实现，该模块通过PCRE库支持正则表达式匹配，可对请求URI进行动态修改。其核心处理流程包含三个阶段：

规则匹配阶段：按配置文件中rewrite指令的顺序依次检查
变量替换阶段：支持$1-$9正则捕获组及Nginx内置变量
重定向阶段：根据标志位决定内部跳转或外部重定向

典型配置示例：

server {
    listen 80;
    server_name example.com;
    location / {
        rewrite ^/user/(.*)$ /profile?id=$1 last;
        rewrite ^/static/(.*)$ /assets/$1 break;
    }
}

二、正则表达式实战技巧

1. 基础匹配模式

精确匹配：^/oldpath$ 完整匹配指定路径
通配匹配：^/images/.*\.jpg$ 匹配所有JPG图片请求
分组捕获：^/article/([0-9]+)$ 提取文章ID

2. 高级匹配技巧

非贪婪匹配：使用?修饰符避免过度匹配

条件判断：结合if指令实现复杂逻辑

if ($http_user_agent ~* MSIE) {
  rewrite ^(.*)$ /ie-special$1 last;
}

命名捕获组：^/product/(?<id>[0-9]+) 通过变量$id访问

3. 性能优化建议

避免在高频路径使用复杂正则
将固定字符串前缀放在正则开头
使用~*进行不区分大小写匹配提升效率

三、标志位控制流详解

1. 常用标志位对比

标志位	行为描述	典型场景
last	停止当前匹配，用新URI重新查找location	多级重写
break	停止当前匹配，在本location处理请求	静态资源重定向
redirect	返回302临时重定向	域名迁移
permanent	返回301永久重定向	SEO优化

2. 复杂流程控制案例

location /download/ {
    rewrite ^/download/(.*)$ /media/$1 break;
    if (!-f $document_root$uri) {
        rewrite ^/media/(.*)$ /404.html last;
    }
    proxy_pass http://media_server;
}

此配置实现：路径转换→文件存在性检查→备用处理的三级流程控制

四、变量系统深度应用

1. 内置变量速查

$request_method：HTTP方法
$http_user_agent：用户代理字符串
$args：查询字符串
$host：请求主机名

2. 自定义变量使用

set $custom_path /default;
if ($arg_type = 'mobile') {
    set $custom_path /mobile;
}
rewrite ^ $custom_path permanent;

3. 变量组合技巧

rewrite ^/user/([0-9]+)$ /profile?id=$1&lang=${http_accept_language:0:2} last;

此示例同时捕获ID并提取浏览器语言前两位

五、典型应用场景解析

1. 旧链接迁移方案

# 永久重定向旧域名
server {
    listen 80;
    server_name old-domain.com;
    return 301 https://new-domain.com$request_uri;
}
# 路径结构变更
rewrite ^/201[0-9]/([0-9]{2})/([0-9]{2})/(.*)$ /archive/$3 last;

2. 移动端适配实现

map $http_user_agent $mobile_suffix {
    default "";
    "~*mobile" "-m";
}
server {
    location / {
        rewrite ^(.*)$ $1$mobile_suffix break;
        proxy_pass http://backend;
    }
}

3. A/B测试分流

split_clients $remote_addr $ab_test {
    50% "group-a";
    50% "group-b";
}
server {
    location / {
        rewrite ^ /experiments/$ab_test$uri last;
    }
}

六、调试与优化策略

1. 日志分析技巧

rewrite_log on;
error_log /var/log/nginx/rewrite.log debug;

通过日志可查看：

实际匹配的正则表达式
变量替换结果
最终重定向目标

2. 性能监控要点

使用nginx -T测试配置语法
通过strace跟踪系统调用
监控rewrite_log输出频率

3. 常见问题排查

现象	可能原因	解决方案
重定向循环	last标志使用不当	检查location匹配顺序
变量未解析	作用域错误	确保set指令在正确上下文
正则失效	特殊字符未转义	使用\对.等字符转义

七、安全最佳实践

输入验证：对用户提供的参数进行过滤
```
if ($args ~* "[^a-zA-Z0-9_]") {
 return 400;
}
```

防开放重定向：限制重定向目标域名

if ($redirect_uri !~ ^(https?:)?//(example.com|sub.example.com)) {
 return 403;
}

CSRF防护：结合token验证机制

通过系统掌握这些技术要点，开发者可以构建出高效、安全、可维护的URL重写方案。在实际应用中，建议结合具体业务场景进行压力测试，持续优化重写规则的性能表现。对于复杂业务系统，可考虑将重写逻辑拆分到不同server块或location块中实现模块化管理。

Nginx中Rewrite规则深度解析与应用指南