在 nginx 中配置永久重定向,需要在 `server` 或 `location` 块中使用 `return` 指令并指定 `301` 状态码。例如,将请求从 `/old-path` 重定向到 `https://example.com/new-path`,只需写入 `return 301 https://example.com/new-path;`。nginx 会立即终止当前请求的处理,并向客户端发送包含新 url 的响应头,浏览器随后会自动发起对新地址的请求。

如何根据域名条件执行永久重定向
当需要根据访问的域名不同而跳转到不同的目标地址时,可以使用 `if` 指令结合 `return` 来实现。这种配置通常用于将非 HTTPS 流量强制跳转至 HTTPS,或者将旧域名统一指向新域名。Nginx 在处理时会先匹配域名,若条件成立则直接返回 301 状态码和新位置。

server {
listen 80;
server_name old.example.com;
# 如果请求的是旧域名,永久重定向到新域名
if ($host = 'old.example.com') {
return 301 https://new.example.com$request_uri;
}
}
上述配置中,`$request_uri` 变量保留了原始请求的路径和查询参数。当用户访问 `http://old.example.com/page?id=1` 时,Nginx 会判断主机名为 `old.example.com`,然后构造新的 URL `https://new.example.com/page?id=1` 并返回 301 状态码。客户端收到后,会将地址栏更新为新地址,且后续请求会直接访问新域名,因为 301 是永久性的,浏览器通常会缓存这个跳转关系。
如何将特定路径下的所有请求永久重定向
对于需要将某个目录下的所有资源迁移到另一个位置的场景,可以使用 `location` 块配合正则表达式来捕获路径部分,并在 `return` 指令中引用捕获组。这种方式可以灵活地重组 URL 结构,同时保持永久重定向的特性。通过 ``、`` 等变量引用正则匹配的内容,可以实现复杂的 URL 重写逻辑。

server {
listen 80;
server_name example.com;
# 将 /blog/ 开头的请求永久重定向到 /articles/
location ~ ^/blog/(.*)$ {
return 301 /articles/$1;
}
}
在这个例子中,正则表达式 `^/blog/(.*)$` 匹配以 `/blog/` 开头的任何 URI,并将斜杠后的所有内容捕获为 `$1`。当请求 `/blog/post-1` 时,`$1` 的值为 `post-1`,`return` 指令将其替换为 `/articles/post-1` 并返回 301 状态码。这种配置确保了旧链接依然有效,但会被永久指向新的结构,有利于 SEO 和用户访问体验。注意,`return` 指令会立即结束处理,因此不需要额外的 `rewrite` 规则。
基于程序中某个输入、条件或结果的具体问题
在使用 `return 301` 时,一个常见的具体问题是:如果目标 URL 中包含特殊字符或中文,Nginx 是否会进行自动编码?答案是 Nginx 不会自动对 `$request_uri` 中的内容进行 URL 编码,它原样传递。如果客户端发送的请求 URI 中包含未编码的特殊字符,Nginx 可能会拒绝处理或产生错误。因此,在构建重定向目标时,应确保 URI 是合法的。如果需要处理复杂的重写逻辑,建议使用 `rewrite` 指令配合 `last` 或 `break`,但对于简单的永久重定向,`return 301` 是最直接且高效的方式。











