nginx关于 error_page指令详解.md

最新推荐文章于 2025-02-14 22:57:36 发布

_双眸

最新推荐文章于 2025-02-14 22:57:36 发布

阅读量2.6k

点赞数

CC 4.0 BY-SA版权

分类专栏： Nginx 文章标签： error_page

本文链接：https://blog.youkuaiyun.com/u010633266/article/details/84973149

3 篇文章

订阅专栏

本文详细介绍了Nginx的error_page指令使用方法，包括如何定义预设的错误页面，如502、503等状态码的处理，以及如何自定义返回状态码。此外，还讲解了error_page指令的高级用法，如内部跳转、外部重定向及递归错误页的设置。

nginx指令error_page的作用是当发生错误的时候能够显示一个预定义的uri，比如：

error_page 502 503 /50x.html;

这样实际上产生了一个内部跳转(internal redirect)，当访问出现502、503的时候就能返回50x.html中的内容。

同时我们也可以自己定义这种情况下的返回状态吗，比如：
error_page 502 503 =200 /50x.html;
这样用户访问产生502 、503的时候给用户的返回状态是200，内容是50x.html。

当error_page后面跟的不是一个静态的内容的话，比如是由proxyed server或者FastCGI/uwsgi/SCGI server处理的话，server返回的状态(200, 302, 401 或者 404）也能返回给用户。

error_page 404 = /404.php;

也可以设置一个named location，然后在里边做对应的处理。

500 502 503 504 @jump_to_error;
location @jump_to_error {    
    ...
}

同时也能够通过使客户端进行302、301等重定向的方式处理错误页面，默认状态码为302。

error_page 403      http://example.com/forbidden.html;
error_page 404 =301 http://example.com/notfound.html;

同时error_page在一次请求中只能响应一次，对应的nginx有另外一个配置可以控制这个选项：recursive_error_pages
默认为false，作用是控制error_page能否在一次请求中触发多次。