Nginx重定向问号用法：清空和覆盖参数的3种实战技巧

引言：为什么你的查询参数总是莫名其妙地翻倍？

配置Nginx重定向时，很多人遇到过这样的怪事：原本只想把 /old?page=1 跳转到 /new?page=2，结果URL变成了 /new?page=2&page=1。查询参数莫名其妙地叠加，甚至出现双重问号。问题的根源在于rewrite指令中那个不起眼的问号符号——它有着特殊的含义和行为机制。

一、问号在rewrite中的特殊含义

根据Nginx官方文档，问号在replacement字符串末尾有特殊作用：阻止原请求参数自动追加。

默认行为：参数自动追加

当replacement字符串不包含问号时，Nginx会自动把原URL的查询字符串追加到新URL后面：

rewrite ^/old(.*)$ /new last;

请求 /old/path?foo=bar 会变成 /new/path?foo=bar，这是大多数人期望的行为。

问号结尾：清空原参数

在replacement末尾加上问号，可以阻止参数追加：

rewrite ^/old(.*)$ /new last;

请求 /old/path?foo=bar 变成 /new/path，原参数被清空。

二、三种典型用法详解

1. 清空所有查询参数

场景：旧系统遗留大量追踪参数（如utm_source、fbclid），需要跳转到干净的URL。

# 清空所有参数，只保留路径
location /legacy {
    rewrite ^/legacy/(.*)$ /clean/ permanent;
}

效果：/legacy/page?utm_source=google&fbclid=abc → /clean/page

2. 覆盖特定参数，丢弃其他参数

场景：分页参数page需要重置，其他参数如搜索关键词要保留。

# 重置page参数为1
location /list {
    if ( ~* "page=") {
        rewrite ^(.*)$ =1? last;
    }
}

注意末尾的问号，它阻止了原page参数的叠加。

3. 选择性保留参数

场景：只保留search参数，丢弃其他所有追踪参数。

location /search {
    if () {
        rewrite ^(.*)$ = last;
    }
}

三、常见错误与解决方法

错误1：双重问号

错误配置：

rewrite ^/old$ /new?foo=bar last;

请求 /old?baz=qux 会变成 /new?foo=bar&baz=qux。

修正：如果只想保留foo=bar，必须在末尾再加一个问号：

rewrite ^/old$ /new?foo=bar? last;

错误2：参数重复叠加

错误配置：

rewrite ^/products/(.*)$ /items?id= last;

请求 /products/123?ref=home 变成 /items?id=123&ref=home。

如果你不希望ref参数跟着过来，加上问号：

rewrite ^/products/(.*)$ /items?id= last;

错误3：与\

很多人试图用 \ 来拼接参数：

rewrite ^/old$ /new?\ last;

这会导致参数出现在问号前面，格式混乱。正确做法：

# 如果原URL有参数，这样写
rewrite ^/old$ /new\\ last;

\ 会在有参数时输出问号，没有参数时为空。

四、与return指令的区别

return指令没有自动追加参数的行为：

return 301 /new;

请求 /old?foo=bar 会跳转到 /new，参数不会跟随。如果需要保留参数：

return 301 \\;

或者更简洁：

return 301 \;

五、最佳实践总结

• 保留所有参数：不加问号，让Nginx自动追加
• 清空所有参数：replacement末尾加问号，如 /new?
• 覆盖部分参数：手动指定参数 + 末尾问号，如 /new?page=1?
• 条件性处理：使用 \\ 配合if判断

结语

问号在rewrite中虽小，却关系到URL重写的成败。掌握它的三种用法——清空、覆盖、选择性保留，能让你在处理复杂重定向规则时游刃有余。记住：问号在末尾是"清空开关"，问号后有内容则只是普通分隔符。

相关文章推荐

• Nginx rewrite问号含义解析：为什么你的查询参数总是莫名消失？
• Nginx rewrite参数保留4种方法对比
• Nginx rewrite问号后如何保留原参数