Nginx return和rewrite在location中谁先执行？优先级规则全解析

前言：一个让很多人踩坑的问题

在Nginx配置中，return和rewrite是两个最常用的重定向指令。很多人以为return写在前面就一定先执行，或者rewrite匹配到了就一定会跳转——但实际情况远比这复杂。本文将彻底讲清楚return和rewrite在location块中的执行优先级规则，帮你避开配置陷阱。

一、Nginx rewrite模块的执行顺序

根据Nginx官方文档，ngx_http_rewrite_module中的指令（包括break、if、return、rewrite、set）遵循以下执行顺序：

1. server级别的rewrite模块指令按书写顺序依次执行
2. 根据请求URI搜索匹配的location
3. 找到的location内的rewrite模块指令按书写顺序依次执行
4. 如果URI被rewrite修改，则重新搜索location（最多循环10次）

关键点：在同一个location内，return和rewrite是按书写顺序依次执行的，而不是某个指令天然优先。

二、return和rewrite在同一location中的优先级

这是最核心的规则：

• return写在rewrite前面 → return先执行，直接返回，rewrite不执行
• rewrite写在return前面 → rewrite先执行，如果匹配且没有break/last标记，继续执行到return

示例1：return在前

location /api {
    return 301 https://new.example.com$request_uri;
    rewrite ^/api/(.*)$ /v2/$1 last;  # 永远不会执行
}

上面的配置中，return在前面，请求到达后直接返回301重定向，下面的rewrite永远不会被执行。

示例2：rewrite在前且匹配

location /old {
    rewrite ^/old/(.*)$ /new/$1 last;
    return 301 https://example.com$request_uri;  # rewrite用last跳转后，不会执行到这里
}

rewrite使用了last标记，匹配后会重新搜索location，不会继续执行下面的return。

示例3：rewrite在前但不匹配

location /test {
    rewrite ^/abc/(.*)$ /def/$1 last;  # /test不匹配，跳过
    return 200 "hello";  # 执行这行
}

rewrite的正则不匹配时，直接跳过，继续执行return。

三、if块中的return和rewrite

if块是rewrite模块的一部分，其中的return和rewrite同样遵循书写顺序规则。但有一个常见陷阱：

location / {
    if ($scheme = http) {
        rewrite ^ https://$host$request_uri redirect;
    }
    if ($host = old.example.com) {
        return 301 https://new.example.com$request_uri;
    }
}

很多人以为两个if是互斥的，但实际上Nginx会按顺序执行所有if块的rewrite模块指令。如果第一个if匹配并执行了rewrite（使用redirect标记），会触发新的location搜索，第二个if不会在当前轮次执行。

四、rewrite标记对执行流程的影响

rewrite指令的最后一个参数（flag）决定了后续行为：

标记	行为	是否继续执行后续指令
last	停止执行当前location的rewrite指令，重新搜索location	否
break	停止执行当前location的rewrite指令，在当前location继续处理请求	否
redirect	返回302临时重定向	否（已返回响应）
permanent	返回301永久重定向	否（已返回响应）
无标记	继续执行后续指令	是

重要：只有rewrite不匹配或者没有标记时，才会继续执行后面的return。

五、server级别和location级别的交互

server级别的rewrite指令在location匹配之前执行：

server {
    rewrite ^/foo/(.*)$ /bar/$1 last;  # 先执行
    location /bar {
        return 200 "matched bar";
    }
    location /foo {
        return 200 "matched foo";  # 如果server级rewrite用last，这里不会执行
    }
}

请求/foo/hello时，server级别的rewrite先执行，URI变为/bar/hello，然后用新URI搜索location，匹配到/bar。

六、5个实战避坑指南

1. return和rewrite不要混用：同一个location中，要么用return做重定向，要么用rewrite，避免混乱
2. return适合简单跳转：整个location跳转到固定URL，用return更清晰高效
3. rewrite适合URL改写：需要正则匹配并改写路径时，用rewrite
4. 注意if块的"副作用"：if中的return会立即响应，不会继续执行其他if
5. 用rewrite_log调试：开启rewrite_log on;可以在error.log中看到rewrite的执行过程

七、调试方法

在server块中添加以下配置，可以在error.log中观察rewrite执行过程：

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

这样每次rewrite的匹配结果都会记录到日志中，方便排查优先级问题。

总结

Nginx中return和rewrite的优先级并不复杂，核心原则就一条：按书写顺序依次执行，遇到终止指令（return、带标记的rewrite）就停止。理解了这个原则，再结合rewrite标记的行为，就能准确预判任何配置的执行结果。

相关文章

• Nginx rewrite和return重定向区别详解：什么场景用哪个、怎么配才正确
• Nginx return和rewrite参数保留区别：两种重定向方式的核心差异与实战选择
• Nginx return和rewrite性能对比测试：实测数据帮你选择最优方案