Nginx 的重定向规则

我之前写过一篇文章（Nginx location 匹配规则）介绍过 Nginx 的 location 匹配规则、proxy_pass 路径拼接替换规则。这两类配置逻辑最大的特点就是规则隐晦，但整体知识点集中，逻辑简单。

而今天要讲解的 Nginx 重定向规则，不但有部分隐藏逻辑、内容复杂，而且正则表达式是必备前置知识，整体上更难。笔者当年也花了不少时间才整理清楚。

Nginx 中实现地址重定向、URL 改写跳转，主要依靠两类指令：return 与 rewrite。

return 仅负责直接返回状态码 + 跳转地址，不会对原始 URL 做复杂的截取和替换，适合简单固定跳转、协议升级、域名迁移、非法请求拦截等场景。

复制代码

# 格式1：仅返回状态码
return 状态码;

# 格式2：状态码(默认为302) + 跳转URL（常用）
return 状态码 目标URL;

return 的语法简单，只需要通过几个示例就能明白。

示例 1：HTTP 强制跳转 HTTPS，永久重定向

复制代码

location / {
    return 301 https://$host$request_uri;
}

示例 2：永久迁移至新域名

复制代码

server {
    listen 80;
    server_name old.com;
    return 301 https://new.com$request_uri;
}

示例 3：非法路径直接拦截

复制代码

location ~ /inner {
    return 403;
}

rewrite 就是 Nginx 的动态 URL 改写工具，能力很强，但是规则也相对复杂。

rewrite 依赖正则表达式匹配请求路径，支持截取分组、路径裁剪、参数拼接、循环改写，专门用来解决复杂场景。

复制代码

rewrite 正则匹配规则 替换后的URL [flag标记];

匹配和替换逻辑相对明确，flag 标记则是 rewrite 容易踩坑的地方，不同标记决定改写后请求的走向：

对于浏览器的感受来说：

无标记、last 和 break 为服务端内部改写路径，浏览器地址栏不变。
redirect / permanent：由浏览器参与跳转，地址栏发生变化，属于外部显性跳转；浏览器会发起一次额外请求访问重定向后的资源，性能上不如 last / break。

示例 1：伪静态改写（动态 URL 转静态地址）

将 /detail?id=123 改写为 /detail/123.html

复制代码

rewrite ^/detail/(\d+)\.html$ /detail?id=$1 break;

示例 2：临时页面跳转

复制代码

rewrite ^/about$ /about-us redirect;

示例 3：rewrite 多次执行（无标记）

复制代码

location /test {
    rewrite ^/test/a /1;
    rewrite ^/1 /2;
}

无标记执行流程：

示例 4：添加 last 标记

复制代码

location /test {
    rewrite ^/test/a /1 last;
    rewrite ^/1 /2;
}

last 标记执行流程：

无标记 / last 模式下，会触发重新查找 location；Nginx 为防止 rewrite 死循环，内置全局计数器，每触发一次"重新查找 location」"，计数器自增 1。
最多仅允许 10 次内部 rewrite 操作，超出限制直接返回 500 错误。