Nginx错误页面配置指南：优雅处理网站故障

作为IT工程师，配置专业的错误页面是提升用户体验的重要环节。以下是Nginx错误页面配置的详细方案：

基础错误页面配置

1. 自定义错误页面

server {
    error_page 404 /404.html;
    error_page 500 502 503 504 /50x.html;

    location = /404.html {
        root /usr/share/nginx/html;
        internal;
    }

    location = /50x.html {
        root /usr/share/nginx/html;
        internal;
    }
}

2. 错误页面路径设置

建议将错误页面存放在统一目录：

error_page 404 /error_pages/404.html;
error_page 500 /error_pages/500.html;

高级配置方案

1. 动态错误页面（PHP/Node.js等）

error_page 404 /error_handler.php;
location = /error_handler.php {
    fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

2. 基于URI的错误处理

location / {
    try_files $uri $uri/ @error_handler;
}

location @error_handler {
    if ($uri ~ ^/admin/) {
        error_page 404 /admin-404.html;
    }
    error_page 404 /404.html;
}

最佳实践

1. 保持品牌一致性

• 错误页面设计应与网站整体风格一致
• 包含导航栏和返回首页的链接

2. 提供有用信息

• 简单解释错误原因
• 建议操作（检查URL、返回首页、联系支持等）
• 适当添加搜索框

3. 状态码正确处理

location /404.html {
    internal;
    return 404;
}

4. 多语言支持

map $http_accept_language $lang {
    default en;
    ~zh zh;
    ~fr fr;
}

server {
    error_page 404 /$lang/404.html;
}

调试技巧

1. 检查Nginx配置语法：

nginx -t

2. 查看错误日志定位问题：

tail -f /var/log/nginx/error.log

3. 测试错误页面响应：

curl -I http://yoursite.com/404.html

通过以上配置，您可以为用户提供专业、友好的错误处理体验，即使在网站出现故障时也能保持良好的用户体验。