NGINX 配置404错误页面跳转指定页面

主要是记录踩过的一个坑。。。

nginx要自定义404和401的页面，但是error_page 配置没有生效，没有正常跳转。

 error_page 404  /404.html;

error_page 404 = http://www.test.com/error.html;

http://tengine.taobao.org/nginx_docs/cn/docs/http/ngx_http_core_module.html#error_page

这是因为我们的404静态资源在上游服务器上，而不是当前nginx直接提供

nginx proxy 启用自定义错误页面：

语法:proxy_intercept_errors on | off;

默认值:

proxy_intercept_errors off;

上下文:http, server, location

当被代理的后端服务器的响应状态码大于等于300时，决定是否直接将响应发送给客户端，亦或将响应转发给nginx由error_page指令来处理。

 proxy_intercept_errors 为on 表示 nginx按照原response code 输出，后端是404就是404。这个变量开启后，我们才能自定义错误页面。

http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_intercept_errors

总结几种404 自定义页面的配置：

第一种：Nginx自己的错误页面

看下面的配置，这种情况下不需要修改任何参数，就能实现这个功能。

server {

    listen      80;

    server_name  www.test.com;

    root   /data/wwwroot/test;

   index  index.html index.htm;

    location / {

    }

    # 定义错误页面码，如果出现相应的错误页面码，转发到那里。

    error_page  404 403 500 502 503 504  /404.html;

    # 承接上面的location。

    location = /404.html {

    # 放错误页面的目录路径。当然默认可以在网站目录下，也可以定义放置错误页面的位置。

        root   /usr/share/nginx/html;

    }

}

第二种：反向代理的错误页面

如果后台静态资源处理报错抛出404，想把这个状态叫Nginx反馈给客户端或者重定向到某个连接，配置如下：

upstream www {

    server 192.168.1.88:80  weight=20 max_fails=2 fail_timeout=30s;

}

server {

    listen       80;

    server_name www.test.com;

    root   /data/wwwroot/test;

    index  index.html index.htm;

     location / {

        if ($request_uri ~* '^/$') {

                    rewrite .*   http://www.test.com/index.html redirect;

        }

        # 关键参数：这个变量开启后，我们才能自定义错误页面，当后端返回404，nginx拦截错误定义错误页面

        proxy_intercept_errors on;

        proxy_pass      http://www;

        proxy_set_header HOST   $host;

        proxy_set_header X-Real-IP      $remote_addr;

        proxy_set_header X-Forwarded-FOR $proxy_add_x_forwarded_for;

    }

    error_page    404  /404.html;

    location = /404.html {

        root   /usr/share/nginx/html;

    }

}

第三种：Nginx解析php代码的错误页面

如果后端是php解析的，需要加一个变量

在http段中加一个变量 fastcgi_intercept_errors on 就可以了。

指定一个错误页面：

error_page    404  /404.html;

location = /404.html {

    root   /usr/share/nginx/html;

}

注意事项：

1.必须要添加：fastcgi_intercept_errors on; 如果这个选项没有设置，即使创建了404.html和配置了error_page也没有效果。

fastcgi_intercept_errors 语法:

fastcgi_intercept_errors on|off

默认: fastcgi_intercept_errors off

当FastCGI后端服务器响应状态码大于等于300时，决定是否直接将响应发送给后端客户端，或者将响应转发给nginx由 error_page指令来处理。

http://nginx.org/en/docs/http/ngx_http_fastcgi_module.html#fastcgi_intercept_errors

fastcgi_intercept_errors on表示接收fastcgi输出的http 1.0 response code，后端php可以输出header指示nginx输出什么错误页面。开启这个之后，我们才能在php里面自定义错误代码和页面。

 添加位置: http, server, location

默认情况下，nginx不支持自定义404错误页面，只有这个指令被设置为on，nginx才支持将404错误重定向。

这里需要注意的是，并不是说设置了on,nginx就会将404错误重定向。

在nginx中404错误重定向生效的前提是设置了fastcgi_intercept_errors on,并且正确的设置了error_page这个选项（包括语法和对应的404页面)

2.不要出于省事或者提高首页权重的目的将首页指定为404错误页面，也不要用其它方法跳转到首页。

3.自定义的404页面必须大于512字节，否则可能会出现IE默认的404页面。例如，假设自定义了404.html,大小只有11个字节（内容为：404错误）。