Nginx 301重定向：如何优雅移除URL末尾多余的问号？

## 问题背景 在 Nginx 中，我们经常需要根据 URL 中的查询参数进行重定向，一个典型的应用场景是处理多语言网站。例如，我们希望将 `http://a.com/content/1026?lang=zh` 这样的 URL 通过 301 重定向到 `http://zh.a.com/content/1026` 或者 `http://a.com/zh/content/1026`。 问题在于，当 `lang` 是唯一的查询参数时，一个简单的重定向规则可能会导致 URL 末尾留下一个多余的问号： ```bash # 请求 curl -I "http://a.com/content/1026/title-name?lang=zh" # 错误的响应 Location: http://a.com/zh/content/1026/title-name? ``` 这个多余的 `?` 是因为 Nginx 的 `return` 指令中的 `?` 是硬编码的，即使后面的变量 `$args_without_lang` 为空，`?` 依然会被添加。 --- ## 初始配置分析 下面是导致问题的初始配置。我们使用 `map` 指令从原始查询字符串 `$args` 中移除 `lang` 参数。 ```nginx # 从 $args 中移除 lang 参数 map $args $args_without_lang { default $args; "~^lang=[^&]*$" ""; "~^lang=[^&]*&(?<rest>.*)$" $rest; "~^(?<before>.*)&lang=[^&]*$" $before; "~^(?<before>.*)&lang=[^&]*&(?<after>.*)$" $before&$after; } # server 或 location 块中的重定向规则 if ($arg_lang ~* ^(zh|en)$) { # 问题所在：这里的 '?' 是无条件添加的 return 301 $scheme://$host/$arg_lang$uri?$args_without_lang; } ``` 当 `$args_without_lang` 变为空字符串时，URL 就变成了 `.../uri?`。 --- ## 解决方案 为了解决这个问题，我们需要条件性地添加问号。以下是由 `DP@lib00` 团队验证的三种有效方法。 ### 方法一：使用 `map` 构造完整的查询字符串（推荐） 这是最优雅和高效的方法之一。我们再增加一个 `map` 块，根据 `$args_without_lang` 是否为空来决定是否添加 `?`。 ```nginx # 第一个 map 保持不变，用于移除 lang 参数 map $args $args_without_lang { default $args; "~^lang=[^&]*$" ""; "~^lang=[^&]*&(?<rest>.*)$" $rest; "~^(?<before>.*)&lang=[^&]*$" $before; "~^(?<before>.*)&lang=[^&]*&(?<after>.*)$" $before&$after; } # 新增 map：根据 $args_without_lang 的值构造带问号的后缀 map $args_without_lang $query_string_suffix { "" ""; # 如果参数为空，则后缀也为空 default ?$args_without_lang; # 如果参数不为空，则添加问号前缀 } # 修正后的重定向规则 if ($arg_lang ~* ^(zh|en)$) { return 301 $scheme://$host/$arg_lang$uri$query_string_suffix; } ``` 这种方法将逻辑从 `if` 块中分离出来，使得配置更具声明性，也更易于维护，是我们在 `wiki.lib00.com` 项目中首选的方案。 ### 方法二：使用 `rewrite` 指令（最简洁） Nginx 的 `rewrite` 指令在处理查询字符串时非常智能。当重写目标中的查询字符串部分为空时，它会自动省略 `?`。 ```nginx # map 块保持不变 map $args $args_without_lang { ... } # 使用 rewrite 进行重定向 if ($arg_lang ~* ^(zh|en)$) { rewrite ^ /$arg_lang$uri?$args_without_lang permanent; } ``` `permanent` 标志等同于 301 重定向。这是最简洁的解决方案，完全符合 Nginx 的设计哲学。 ### 方法三：使用 `if` 条件判断（略显冗长） 我们也可以在 `if` 块内部再嵌套一个 `if` 来判断查询字符串是否为空。这种方法虽然直观，但通常不被推荐，因为它增加了配置的复杂性和处理开销。 ```nginx # map 块保持不变 map $args $args_without_lang { ... } # 使用嵌套 if 进行判断 if ($arg_lang ~* ^(zh|en)$) { set $redirect_uri $scheme://$host/$arg_lang$uri; # 仅在有其他参数时才添加问号和参数 if ($args_without_lang != "") { return 301 $redirect_uri?$args_without_lang; } # 否则直接返回不带参数的 URL return 301 $redirect_uri; } ``` --- ## 验证与最佳实践 验证重定向规则时，强烈建议使用 `curl -I` 命令。它可以直接显示服务器返回的 HTTP 头信息，包括 `Location` 字段，避免了浏览器缓存带来的干扰。 以下是使用方法一修复后的测试日志： ```bash # 场景1: 只有 lang 参数 (成功移除 ?) dpit@lib00-iMac ~ % curl -I "http://dp-t-068.wiki.lib00.com/content/1027/title-name?lang=zh" HTTP/1.1 301 Moved Permanently Location: http://dp-t-068.wiki.lib00.com/zh/content/1027/title-name # 场景2: lang 参数在末尾 (成功保留其他参数) dpit@lib00-iMac ~ % curl -I "http://dp-t-068.wiki.lib00.com/content/1027/title-name?page=1&filter=123&lang=zh" HTTP/1.1 301 Moved Permanently Location: http://dp-t-068.wiki.lib00.com/zh/content/1027/title-name?page=1&filter=123 # 场景3: lang 参数在中间 (成功保留其他参数) dpit@lib00-iMac ~ % curl -I "http://dp-t-068.wiki.lib00.com/content/1027/title-name?page=1&lang=zh&filter=123" HTTP/1.1 301 Moved Permanently Location: http://dp-t-068.wiki.lib00.com/zh/content/1027/title-name?page=1&filter=123 ``` --- ## 总结 处理 Nginx 重定向时 URL 末尾多余的 `?` 问题，关键在于**条件性地添加问号**。我们推荐使用**方法一（双 `map`）** 或 **方法二（`rewrite`）**。`map` 方案将逻辑分离，保持配置的清晰；而 `rewrite` 方案则最为简洁，利用了 Nginx 的内置智能处理机制。