nginx 重写(rewrite) 重定向(return error_page) 详解

使用 rewrite 指令用于重写URL

Nginx的rewrite指令用于重写URL，它有几个参数，这些参数定义了如何匹配和重写请求的URL。以下是rewrite指令的常见参数及其说明：

1. Regex：这是一个正则表达式，用于匹配请求的URI。Nginx将使用这个正则表达式来查找与请求URI相匹配的模式。
2. Replacement：这是重写后的URI，可以包含正则表达式的捕获组，这些捕获组可以在重写过程中被引用。
3. Flag：标志用于控制重写过程的行为。Nginx支持多个标志，但每次只能使用一个。常见的标志包括：
   • last：停止处理当前的server或location块中的后续rewrite指令，并开始搜索与重写后的URI相匹配的新的location块。如果找到了匹配的location块，Nginx将重新开始处理该块中的指令。
   • break：停止处理当前的server或location块中的后续rewrite指令，并且不会搜索与重写后的URI相匹配的新的location块。Nginx将继续处理当前location块中的其他指令。
   • redirect：返回302临时重定向，告诉客户端使用新的URI重新请求。注意，这个标志会导致客户端看到重定向响应，并且可能会改变浏览器的地址栏。
   • permanent：返回301永久重定向，与redirect类似，但告诉客户端这个重定向是永久的。同样，客户端会看到重定向响应，并且浏览器的地址栏可能会更新。

以下是一个rewrite指令的示例：

nginx复制代码

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

在这个示例中：

• ^/old-path/(.*)$ 是正则表达式，匹配以/old-path/开头的URI，并捕获该路径之后的所有内容。
• /new-path/$1 是重写后的URI，其中$1引用了正则表达式中的第一个捕获组的内容。
• last 是一个标志，指示Nginx在重写后搜索新的location块来处理请求。

请注意，在配置Nginx时，rewrite指令应该谨慎使用，并且通常建议尽可能使用location块和try_files指令来实现URL重写和请求处理，因为它们通常更易于理解和维护。

在Nginx中，return 和 error_page 指令都可以用于重定向，但它们的使用场景和目的略有不同。下面是关于如何使用这两个指令进行重定向的说明：

使用 return 指令进行重定向

return 指令允许你在Nginx配置中直接返回HTTP响应给客户端。它可以用于重定向、返回静态内容或设置特定的HTTP响应代码。

要进行重定向，你可以使用 return 指令配合HTTP状态码301（永久重定向）或302（临时重定向）。例如：

nginx
server {
listen 80;
server_name example.com;

location /old-path/ {  
    return 301 http://example.com/new-path/;  
}  

}
在上面的配置中，当请求 http://example.com/old-path/ 时，Nginx会返回一个301重定向响应，将客户端重定向到 http://example.com/new-path/。

使用 error_page 指令进行重定向

error_page 指令通常用于定义自定义错误页面，但它也可以用于重定向。当Nginx遇到特定的HTTP错误状态时，可以使用 error_page 指令来指定一个URL进行重定向。这在处理维护模式、站点迁移或临时不可用页面时特别有用。

例如，你可以将404错误重定向到一个统一的错误处理页面：

nginx
server {
listen 80;
server_name example.com;

location / {  
    # ... 其他配置 ...  
}  

error_page 404 = @not_found;  

location @not_found {  
    return 301 http://example.com/error;  
}  

}
在这个配置中，如果Nginx找不到请求的资源并返回404错误，它将被重定向到 http://example.com/error 页面。但请注意，使用301重定向作为错误页面可能不是最佳实践，因为301是一个永久重定向，意味着浏览器可能会缓存这个重定向，即使在错误被解决后也可能继续重定向到错误页面。在这种情况下，使用302或307（临时重定向）可能更合适。

然而，更常见的做法是直接为错误页面指定一个静态文件或内部URI，而不是进行重定向：

nginx
server {
listen 80;
server_name example.com;

location / {  
    # ... 其他配置 ...  
}  

error_page 404 /error.html;  

location = /error.html {  
    root /path/to/error/pages;  
    internal;  
}  

}
在这个配置中，404错误将直接展示位于 /path/to/error/pages/error.html 的静态错误页面，而不是进行重定向。