Nginx如何进行错误页面跳转_运维文库_资讯中心

发布时间:2026-04-27 06:20:55

阅读量:2

在Nginx中，您可以使用error_page指令来定义自定义错误页面，并使用return或rewrite指令来实现错误页面的跳转。以下是一些示例：

基本错误页面跳转：

在Nginx配置文件中的http、server或location块中，使用error_page指令定义错误代码和自定义错误页面的路径。然后，在相应的location块中使用return或rewrite指令实现跳转。

例如，将404错误重定向到自定义的404页面：

http {
    ...
    error_page 404 /custom_404.html;
    ...
    server {
        ...
        location / {
            ...
        }
        location = /custom_404.html {
            root /var/www/html;
        }
    }
}

使用rewrite指令实现错误页面跳转：

在Nginx配置文件中的http、server或location块中，使用error_page指令定义错误代码和重定向的目标URL。然后，在相应的location块中使用rewrite指令实现跳转。

例如，将404错误重定向到自定义的404页面：

http {
    ...
    error_page 404 = @custom_404;
    ...
    server {
        ...
        location / {
            ...
        }
        location @custom_404 {
            rewrite ^(.*)$ /custom_404.html last;
        }
        location = /custom_404.html {
            root /var/www/html;
        }
    }
}

注意：在使用rewrite指令时，需要添加last标志，以确保重写后的URL被正确处理。

使用外部重定向实现错误页面跳转：

在Nginx配置文件中的http、server或location块中，使用error_page指令定义错误代码和重定向的目标URL。然后，在相应的location块中使用return指令实现跳转。

例如，将404错误重定向到外部URL：

http {
    ...
    error_page 404 = @external_redirect;
    ...
    server {
        ...
        location / {
            ...
        }
        location @external_redirect {
            return 301 http://example.com/custom_404.html;
        }
    }
}

根据您的需求选择合适的方法，并确保自定义错误页面的路径或目标URL正确。在修改配置文件后，不要忘记重新加载Nginx以使更改生效：