一、路径重写核心机制解析

Nginx的路径重写功能通过rewrite指令实现，其语法结构为：

rewrite regex replacement [flag];

正则表达式(regex)：支持Perl兼容正则，可捕获路径片段
替换字符串(replacement)：支持变量引用（如$1-$9）和Nginx内置变量
标志位(flag)：控制重写行为（last/break/redirect/permanent）

1.1 标志位深度解析

标志位	行为特征	典型场景
`last`	终止当前location块处理，重新搜索匹配location	多级路径转换
`break`	立即停止重写处理，继续执行后续指令	路径映射+别名组合
`redirect`	返回302临时重定向，浏览器地址栏变化	测试环境路径迁移
`permanent`	返回301永久重定向，利于SEO优化	域名或路径结构调整

1.2 正则表达式进阶

非贪婪匹配：使用.*?避免过度匹配
字符集优化：[^/]+匹配非斜杠字符
命名捕获组：?<name>支持更清晰的变量引用（需Nginx 1.18+）

二、典型业务场景实现

2.1 基础路径迁移

# 将旧路径/v1/api/users迁移到/api/v2/users
location /v1/api {
    rewrite ^/v1/api/(.*)$ /api/v2/$1 last;
}

处理流程：

匹配/v1/api/users
捕获users到$1
重写为/api/v2/users
重新匹配location块

2.2 动态参数转换

# 将RESTful路径转换为查询参数
location /search {
    rewrite ^/search/(\w+)/(\w+)$ /search?category=$1&keyword=$2 last;
}

变量映射表：
| 路径片段 | 查询参数 |
|——————|——————|
| $1(第一个) | category |
| $2(第二个) | keyword |

2.3 尾部斜杠强制规范

# 统一添加尾部斜杠（SEO优化）
rewrite ^([^.\?]*[^/])$ $1/ permanent;

特殊处理：

排除含查询字符串的URL（[^?\?]*）
避免对已含斜杠的路径重复处理

三、高级组合技巧

3.1 rewrite+alias黄金组合

# 静态资源CDN加速配置
location /assets/ {
    rewrite ^/assets/(.*)$ /cdn/$1 break;
    alias /data/static/;
    expires 30d;
}

处理逻辑：

将/assets/logo.png重写为/cdn/logo.png
alias指令映射到实际路径/data/static/logo.png
设置30天缓存头

3.2 try_files智能回源

# SPA应用路由处理
location / {
    try_files $uri $uri/ /index.html;
    if (!-e $request_filename) {
        rewrite ^/(.*)$ /index.html last;
    }
}

双保险机制：

先尝试直接返回静态文件
不存在时返回index.html
通过if补充检查确保可靠性

3.3 条件重定向实践

# 多语言站点重定向
map $arg_lang $redirect_lang {
    default     "";
    en         /en;
    zh-CN      /cn;
}
server {
    if ($redirect_lang) {
        rewrite ^ $redirect_lang$uri permanent;
    }
}

优化点：

使用map预处理提高性能
避免在location块外使用if

四、性能优化与安全实践

4.1 性能优化策略

正则表达式优化：
- 避免复杂正则，优先使用前缀匹配
- 对高频请求使用location ~^前缀匹配

减少重写次数：

# 不推荐（两次重写）
rewrite ^/old(/.*)?$ /new$1 break;
rewrite ^/new(/.*)$ /final$1 last;
# 推荐（单次重写）
rewrite ^/old(/.*)?$ /final$1 last;

缓存重写结果：

geo $rewrite_cache {
    default 0;
    /static/ 1;
}
server {
    if ($rewrite_cache) {
        rewrite ^ /cached$uri last;
    }
}

4.2 安全防护措施

防止URL跳转漏洞：

# 限制重定向域名
valid_referers none blocked server_names *.example.com;
if ($invalid_referer) {
    rewrite ^ /403.html;
}

防路径遍历攻击：

# 过滤../等危险字符
if ($request_uri ~* "\.\./") {
    return 400;
}

限制重写深度：

# 防止重写循环（需1.15.6+）
rewrite_log on;
max_rewrites 3;

五、完整配置示例

5.1 电商网站API网关

server {
    listen 80;
    server_name api.example.com;
    # 版本号迁移
    rewrite ^/v1/(.*)$ /api/$1 last;
    # JWT验证代理
    location /api/auth {
        proxy_set_header Authorization $http_Authorization;
        proxy_pass http://auth-service;
    }
    # 商品服务路由
    location /api/products {
        if ($args ~* "category=") {
            rewrite ^ /api/search last;
        }
        proxy_pass http://product-service;
    }
    # 搜索服务
    location /api/search {
        set $search_args $args;
        if ($arg_q) {
            set $search_args "keyword=$arg_q&$args";
        }
        proxy_pass http://search-service?$search_args;
    }
}

5.2 多环境部署方案

map $http_host $env_prefix {
    default         "";
    dev.example.com "/dev";
    stage.example.com "/stage";
}
server {
    root /var/www/app;
    location / {
        rewrite ^ $env_prefix$uri last;
        try_files $uri $uri/ /index.html;
    }
    # 开发环境特殊处理
    location /dev/ {
        access_log /var/log/nginx/dev-access.log;
        error_log /var/log/nginx/dev-error.log debug;
    }
}

六、调试与监控

重写日志配置：

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

实时监控指标：
- 通过stub_status监控重写次数
- 使用日志分析工具统计301/302占比

AB测试方案：

split_clients $remote_addr $rewrite_variant {
    50% "";
    50% ".v2";
}
server {
    location / {
        rewrite ^ /static$rewrite_variant$uri last;
    }
}

本文通过系统化的技术解析和丰富的实战案例，帮助开发者全面掌握Nginx路径重写技术。从基础语法到高阶技巧，从性能优化到安全防护，覆盖了实际生产环境中的核心需求。建议开发者结合具体业务场景进行针对性配置，并通过日志分析和性能测试持续优化重写规则。

Nginx路径重写全攻略：从基础到高阶的完整实践指南