Nginx Rewrite功能详解与实战优化指南

1. Nginx Rewrite 功能深度解析

Nginx的rewrite模块是每个Web运维工程师必须掌握的瑞士军刀。不同于简单的重定向，rewrite能实现URL的智能变形和路由控制。我在处理日均千万级请求的电商平台时，90%的URL规则都依赖rewrite实现。这个看似简单的功能，用好了能让你的运维效率提升300%。

rewrite的核心价值在于：它能在不修改应用代码的情况下，实现URL的标准化、AB测试路由、新旧系统迁移等复杂场景。比如把/product/123变成/item.php?id=123，或者把移动端请求自动导向移动版域名。更重要的是，rewrite发生在Nginx的HTTP处理早期阶段，性能损耗几乎可以忽略不计。

2. Rewrite 指令完全手册

2.1 rewrite 基础语法

rewrite指令的标准格式看似简单：

nginx复制rewrite regex replacement [flag];

但每个参数都有魔鬼细节：

• regex：使用PCRE正则，注意~表示区分大小写，~*不区分。我曾踩过坑：rewrite ~^/user/(\d+) 会匹配/User/123失败，应该用~*

• replacement：替换字符串时，$1到$9捕获分组。有个高级技巧：如果replacement以http://开头，Nginx会自动触发302重定向

• flag参数有四个隐藏特性：

  • last：终止当前location的rewrite检测，但会重新发起新一轮location匹配
  • break：立即停止所有rewrite处理
  • redirect：强制302临时重定向（即使replacement不是URL）
  • permanent：返回301永久重定向

关键经验：在location中使用rewrite时，90%的情况应该用break而非last，避免rewrite循环。只有需要跨location重写时才用last

2.2 变量与条件组合

Nginx的if指令配合rewrite能实现智能路由。这是我在灰度发布中使用的真实配置：

nginx复制set $canary "";
if ($http_user_agent ~* "(iPhone|Android)") {
    set $canary "Y";
}

if ($arg_test = "1") {
    set $canary "Y";
}

location / {
    rewrite ^/(.*)$ /v2/$1 break;
}

注意if的坑：

1. if创建隐式上下文，某些指令在其中不可用
2. 避免多个if嵌套，改用set+map组合
3. 判断相等应该用=而非==（Nginx的奇葩语法）

2.3 try_files 的妙用

try_files本质是增强版rewrite，我的常用模式：

nginx复制location / {
    try_files $uri $uri/ @backend;
}

location @backend {
    rewrite ^/(.*)$ /index.php?route=$1 break;
}

这实现了：

1. 先检查静态文件是否存在
2. 不存在则转给PHP处理
3. 保持原始URL美观

3. 生产环境实战案例

3.1 新旧系统迁移方案

当需要从旧系统迁移到新系统时，rewrite可以平滑过渡。这是我为某新闻网站设计的迁移方案：

nginx复制# 旧文章URL：/news-123.html
# 新文章URL：/article/123

rewrite ^/news-(\d+)\.html$ /article/$1 permanent;
rewrite ^/article/(\d+)$ /index.php?id=$1 break;

关键点：

1. 先用301永久重定向更新搜索引擎索引
2. 内部重写为新系统的处理格式
3. 保留旧URL参数（如UTM跟踪参数）

3.2 多租户SaaS路由

处理SaaS平台的子域名路由时，rewrite比DNS更灵活：

nginx复制server {
    listen 80;
    server_name ~^(?<subdomain>.+)\.example\.com$;
    
    location / {
        rewrite ^ /$subdomain$uri break;
        proxy_pass http://backend;
    }
}

这个配置实现：

1. 捕获任意子域名作为变量
2. 将子域名作为路径前缀转发
3. 后端应用无需处理域名逻辑

3.3 动态文件版本控制

解决浏览器缓存问题的经典方案：

nginx复制location /static {
    rewrite ^/static/(.*)\.v\d+\.(js|css)$ /static/$1.$2 break;
    expires 1y;
    add_header Cache-Control "public";
}

匹配/static/app.v123.js实际返回app.js，同时设置长期缓存

4. 性能优化与排错指南

4.1 正则表达式优化

低效正则会导致CPU飙升。经验法则：

1. 避免.*贪婪匹配，改用[^/]*等限定范围
2. 将^(prefix|alternative)改为^prefix或^alternative
3. 使用rewrite_log on;调试时开启日志（记得关！）

4.2 常见错误代码

• 500循环重定向：检查是否有rewrite->location->rewrite的死循环
• 404意外丢失：try_files的fallback参数缺失
• URI参数消失：在replacement后添加?$args保留原始参数

4.3 调试技巧

1. 使用return 200 "$uri $args";临时输出调试信息
2. 按这个顺序检查问题：
   • 正则是否匹配（测试工具：pcretest）
   • flag是否正确（break/last混用最常见）
   • 变量值是否符合预期（通过access_log记录）
3. 终极武器：strace -p nginx_pid跟踪系统调用

5. 高级技巧与边缘案例

5.1 map指令动态路由

map比if更适合复杂条件：

nginx复制map $http_user_agent $route {
    default "desktop";
    "~*iPhone" "mobile";
    "~*Android" "mobile";
}

server {
    rewrite ^/(.*)$ /$route/$1 break;
}

5.2 地理路由方案

配合GeoIP模块实现地域分流：

nginx复制geo $country {
    default US;
    1.0.0.0 AU;
    2.0.0.0 CN;
}

location / {
    rewrite ^/(.*)$ /$country/$1 break;
}

5.3 流量镜像技巧

AB测试时复制流量：

nginx复制location / {
    rewrite ^/(.*)$ @test break;
    proxy_pass http://production;
}

location @test {
    proxy_pass http://test;
    proxy_set_header X-Mirrored "true";
}

6. 安全防护实践

6.1 注入攻击防护

过滤恶意URL模式：

nginx复制if ($request_uri ~* "(\.\./|\.php$)") {
    return 403;
}

6.2 敏感路径隐藏

伪装管理后台：

nginx复制rewrite ^/admin/(.*)$ /special_$1 break;

6.3 爬虫流量管理

限制扫描行为：

nginx复制if ($http_user_agent ~* (bot|crawl)) {
    rewrite ^/(.*)$ /robot_check?url=$1 redirect;
}

7. 性能对比测试数据

在我的测试环境中（4核8G，1000并发）：

结论：

1. 简单rewrite对性能影响<5%
2. 避免在rewrite中使用复杂if条件
3. 超过20条规则应考虑拆分为多个location