如何在Nginx中正确设置自定义404错误页面并确保返回404状态码？

在Nginx中定义404页面并返回404状态码是提升用户体验和网站专业性的重要步骤，下面将详细介绍如何在Nginx中正确配置自定义的404页面，确保当用户请求不存在的页面时，能够看到一个友好的错误提示页面，同时保持正确的HTTP状态码。

基本配置方法

1、创建自定义404页面：

需要创建一个自定义的404错误页面文件，例如404.html，这个文件应包含用户在访问到不存在的页面时应看到的内容和样式。

示例内容可能包括一个友好的错误消息、搜索框、站点地图链接或者首页链接等，以帮助用户导航到其他页面。

2、配置Nginx使用自定义404页面：

打开Nginx的配置文件（通常是nginx.conf），找到或添加server块。

在server块内，使用error_page指令来指定当发生404错误时应显示的页面。

“`nginx

server {

listen 80;

server_name example.com;

root /var/www/html;

…

error_page 404 /custom_404.html;

location = /custom_404.html {

root /var/www/html;

internal;

}

…

}

“`

这里，error_page 404 /custom_404.html;告诉Nginx当发生404错误时使用/custom_404.html页面作为响应。

location = /custom_404.html块确保了这个页面只能通过Nginx内部重定向访问，不能直接被客户端请求。

3、检查配置并重启Nginx：

保存配置文件后，使用nginx t命令检查配置文件的语法是否正确。

如果一切正常，使用systemctl restart nginx或service nginx restart命令重启Nginx服务使配置生效。

高级配置选项

对于更复杂的应用场景，如使用反向代理或处理特定类型的请求（如PHP脚本），可能需要额外的配置：

1、反向代理情况下的配置：

如果在Nginx后面还有其他服务器（如Apache、Tomcat等），并且希望Nginx拦截来自这些服务器的404错误并显示自定义页面，需要启用proxy_intercept_errors on;选项。

这样设置后，当后端服务器返回404错误时，Nginx会捕获这个错误并显示自定义的404页面。

2、处理PHP脚本的错误：

对于PHP脚本生成的错误，除了上述的proxy_intercept_errors配置外，还需要在location ~ .php$块中添加fastcgi_intercept_errors on;来确保Nginx能捕获FastCGI服务器返回的错误。

注意事项

确保自定义的404页面文件大小超过512字节，以避免在某些浏览器（如IE）中触发默认的404页面。

不要简单地将404错误页面设置为首页或其他重要页面，这可能会影响SEO并对用户体验产生负面影响。

定期测试自定义的404页面以确保其正常工作，特别是在网站结构发生变化后。

FAQs

1、为什么自定义的404页面没有生效？

确保已经正确编辑了Nginx的配置文件，并且使用了error_page指令指定了自定义的404页面路径，如果仍然不生效，请检查Nginx的错误日志以获取更多信息。

2、是否可以为不同的错误代码设置不同的自定义页面？

是的，Nginx允许为不同的HTTP错误代码设置不同的自定义页面，可以使用error_page 500 /50x.html;来为500错误设置另一个自定义页面，只需按照相同的方式配置即可。

通过上述步骤，可以在Nginx中成功配置自定义的404页面，并在用户遇到找不到的页面时提供一个友好的界面，而不是默认的错误信息，这不仅增强了网站的可用性，也有助于维护网站的专业形象。

定义服务器块
server {
    # 监听80端口
    listen 80;
    # 设置服务器名称或IP地址
    server_name example.com;
    # 定义根目录
    root /usr/share/nginx/html;
    # 如果请求的资源不存在，则返回404状态码和自定义的404页面
    error_page 404 /404.html;
    # 配置location块，匹配所有路径
    location / {
        # 如果请求的资源不存在，则返回404.html页面
        try_files $uri $uri/ =404;
    }
}

说明：

1、error_page 404 /404.html; 这行代码告诉Nginx，当返回404错误时，应该使用/404.html页面。

2、try_files $uri $uri/ =404; 这行代码是一个重定向规则，它尝试按顺序查找以下文件：

$uri：请求的原始URI。

$uri/：请求的URI后跟一个斜杠。

如果上述文件都不存在，则返回404状态码。

3、server_name example.com; 这行代码指定了服务器的域名或IP地址。

4、root /usr/share/nginx/html; 这行代码设置了服务器的根目录，即静态文件存放的位置。

通过以上配置，当用户访问不存在的页面时，Nginx会返回一个自定义的404页面，并显示404状态码。