Nginx Rewrite 规则冲突的排查技巧

Nginx Rewrite 规则冲突的排查技巧：从混乱到清晰的实战指南

作为一名运维工程师，我在处理 Nginx 配置时最常遇到的问题之一就是 rewrite 规则冲突。上周刚解决了一个线上环境的重定向循环问题，今天就和大家分享这些实用的排查技巧。

1. 理解 rewrite 规则的执行顺序

很多冲突其实源于对执行顺序的误解。Nginx 的 rewrite 规则是按照配置文件中出现的顺序执行的，但 location 块有优先级。记住这个顺序：

# 精确匹配 location = /path
# 前缀匹配 location ^~ /path  
# 正则匹配 location ~ /path
# 通用匹配 location /path

2. 启用 rewrite_log 进行调试

这是我最喜欢的调试方法。在 nginx.conf 中添加：

server {
    rewrite_log on;
    error_log /var/log/nginx/error.log notice;
}

然后重载配置，观察 error.log，你会看到每个 rewrite 规则的执行详情。

3. 使用 return 替代 rewrite 进行测试

当怀疑某个 rewrite 规则有问题时，我经常先用 return 测试：

location /test {
    # 临时注释掉 rewrite
    # rewrite ^/test/(.*)$ /new/$1 permanent;
    return 200 "Testing location match";
}

这样可以确认 location 是否按预期匹配。

4. 检查 flag 的使用

last、break、redirect、permanent 这些 flag 经常被混淆：

# 这个规则可能会导致意外行为
rewrite ^/old /new last;
rewrite ^/new /final last;  # 可能不会执行

记住：last 会重新开始匹配，break 会停止当前 location 内的 rewrite。

5. 实战案例：解决重定向循环

我最近遇到的一个真实案例：

location /api {
    rewrite ^/api/(.*)$ /v1/api/$1 permanent;
}

location /v1/api {
    rewrite ^/v1/api/(.*)$ /api/$1 permanent;  # 这里造成了循环
}

解决方案是检查整个配置中的相关规则，确保没有形成闭环。

6. 使用 curl 进行逐步测试

命令行测试比浏览器更可靠：

curl -I http://yoursite.com/problematic-url
curl -L --max-redirs 5 http://yoursite.com/url  # 限制重定向次数

7. 配置语法检查工具

每次修改后都要检查：

nginx -t
nginx -T  # 显示完整配置，便于排查

通过这些方法，我成功解决了无数个 rewrite 冲突问题。记住，耐心和系统性排查是关键。下次遇到 rewrite 问题时，不妨按照这个流程走一遍，相信你也能快速定位问题所在！