请求配置WordPress全站自定义错误页面：覆盖各类服务器与PHP错误

嘿，我完全理解你想要给WordPress站点做全场景错误兜底的需求——不管是服务器返回的401/502/500这类状态码错误，还是PHP层面的语法、致命错误，甚至是插件冲突导致的白屏，都要替换成自定义的提示页面或者重定向到统一的错误页。你之前查的那些方向其实都对，只是需要把它们组合起来，覆盖所有场景。我整理了一套完整的可行方案，你可以一步步来：

Apache服务器下，.htaccess是处理这类错误的核心，注意要把配置放在WordPress默认的Rewrite规则之前，不然可能不生效。

• 如果想要重定向到自定义WordPress页面（比如你提前创建的/error-page/）：
  在.htaccess开头添加：

  ErrorDocument 401 /error-page/
  ErrorDocument 403 /error-page/
  ErrorDocument 404 /error-page/
  ErrorDocument 500 /error-page/
  ErrorDocument 502 /error-page/
  

  大部分Apache环境支持相对路径，要是不行就换成绝对URL（比如https://yourdomain.com/error-page/）。

• 如果不想跳转，直接显示自定义HTML内容（避免跳转失败的情况）：
  比如针对500错误：

  ErrorDocument 500 "<!DOCTYPE html><html><head><title>服务器维护中</title></head><body><h1>抱歉，站点暂时无法访问</h1><p>我们正在紧急修复，预计10分钟内恢复</p></body></html>"
  

注意：如果用Nginx服务器，.htaccess无效，需要在站点配置文件里添加：

error_page 401 /error-page/;
error_page 403 /error-page/;
error_page 404 /error-page/;
error_page 500 502 503 504 /error-page/;
location = /error-page/ {
    try_files $uri $uri/ /index.php?$args; # 确保请求转发给WordPress处理自定义页面
}

WordPress默认会隐藏PHP错误，我们需要先调整配置，再用自定义代码捕获所有错误场景。

1. 修改wp-config.php基础设置 #

找到原来的WP_DEBUG相关配置，替换成：

define('WP_DEBUG', true); // 开启调试模式（生产环境可以设为false，但保留下面的配置）
define('WP_DEBUG_DISPLAY', false); // 禁止前端显示默认错误信息
define('WP_DEBUG_LOG', true); // 可选：把错误日志写到wp-content/debug.log，方便排查问题
define('WP_DISABLE_FATAL_ERROR_HANDLER', true); // 禁用WordPress自带的致命错误处理，让我们自己接管

2. 添加自定义错误处理函数 #

你可以把这段代码放到当前主题的functions.php里，或者创建一个独立的自定义插件（更安全，主题更新不会丢失）：

// 捕获PHP致命错误（语法错误、核心错误等）
function custom_fatal_error_handler() {
    $error = error_get_last();
    // 判断是否是致命错误类型
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR])) {
        ob_clean(); // 清空之前可能输出的内容，避免HTTP头发送失败
        header('HTTP/1.1 500 Internal Server Error');
        // 直接输出自定义错误页面（比重定向更可靠，因为致命错误可能导致WordPress无法初始化）
        echo '<!DOCTYPE html>
        <html lang="zh-CN">
        <head>
            <meta charset="UTF-8">
            <title>站点出错了</title>
            <style>
                body { font-family: "Microsoft Yahei", Arial, sans-serif; text-align: center; padding: 60px; background-color: #f8f9fa; }
                .error-box { max-width: 600px; margin: 0 auto; background: white; padding: 40px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
                h1 { color: #dc3545; font-size: 2.5em; margin-bottom: 20px; }
                p { color: #6c757d; font-size: 1.1em; }
            </style>
        </head>
        <body>
            <div class="error-box">
                <h1>😵 站点出现了严重问题</h1>
                <p>我们已经收到通知，正在紧急修复，请稍后再来尝试~</p>
            </div>
        </body>
        </html>';
        exit;
    }
}
add_action('shutdown', 'custom_fatal_error_handler');

// 捕获未捕获的PHP异常
function custom_exception_handler($exception) {
    ob_clean();
    header('HTTP/1.1 500 Internal Server Error');
    // 这里可以和上面的致命错误用同一个页面，或者单独定制
    echo '<!DOCTYPE html>
    <html lang="zh-CN">
    <head>
        <meta charset="UTF-8">
        <title>程序异常</title>
        <style>
            body { font-family: "Microsoft Yahei", Arial, sans-serif; text-align: center; padding: 60px; background-color: #f8f9fa; }
            .error-box { max-width: 600px; margin: 0 auto; background: white; padding: 40px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
            h1 { color: #dc3545; font-size: 2.5em; margin-bottom: 20px; }
            p { color: #6c757d; font-size: 1.1em; }
        </style>
    </head>
    <body>
        <div class="error-box">
            <h1>⚠️ 程序运行异常</h1>
            <p>我们正在排查问题，感谢你的耐心等待~</p>
        </div>
    </body>
    </html>';
    exit;
}
set_exception_handler('custom_exception_handler');

// 可选：捕获PHP警告、通知等非致命错误（如果想统一处理）
function custom_error_handler($errno, $errstr, $errfile, $errline) {
    // 只处理我们关心的错误类型（可以根据需求调整）
    if (!(error_reporting() & $errno)) {
        return;
    }
    ob_clean();
    wp_redirect(home_url('/error-page/'));
    exit;
}
set_error_handler('custom_error_handler');

如果插件或主题的错误导致WordPress根本无法初始化，上面的主题functions.php代码可能不会执行。这时候需要用MU插件（必须使用的插件），它会在所有其他插件和主题之前加载。

1. 在wp-content目录下创建mu-plugins文件夹（如果没有的话）
2. 在里面创建文件custom-error-handler.php，内容：

<?php
/**
 * MU Plugin: 全局错误兜底
 */
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR])) {
        ob_clean();
        header('HTTP/1.1 500 Internal Server Error');
        // 输出和之前一致的自定义错误页面
        echo '<!DOCTYPE html>
        <html lang="zh-CN">
        <head>
            <meta charset="UTF-8">
            <title>站点出错了</title>
            <style>
                body { font-family: "Microsoft Yahei", Arial, sans-serif; text-align: center; padding: 60px; background-color: #f8f9fa; }
                .error-box { max-width: 600px; margin: 0 auto; background: white; padding: 40px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
                h1 { color: #dc3545; font-size: 2.5em; margin-bottom: 20px; }
                p { color: #6c757d; font-size: 1.1em; }
            </style>
        </head>
        <body>
            <div class="error-box">
                <h1>😵 站点出现了严重问题</h1>
                <p>我们已经收到通知，正在紧急修复，请稍后再来尝试~</p>
            </div>
        </body>
        </html>';
        exit;
    }
});

MU插件不需要激活，放在目录里就会自动生效，完美解决初始化前的白屏问题。

一定要逐个场景测试，确保所有错误都被覆盖：

• 404错误：访问一个不存在的URL（比如https://yourdomain.com/xxxxxx/）
• 500错误：在functions.php里加一行trigger_error('Test fatal error', E_USER_ERROR);，然后访问站点
• 语法错误：在某个PHP文件里故意写个语法错误（比如少个分号），刷新页面
• 401错误：设置一个受保护的目录，访问它触发权限验证

• 生产环境可以把WP_DEBUG设为false，但要保留WP_DISABLE_FATAL_ERROR_HANDLER为true，确保自定义错误处理生效
• 自定义错误页面的样式要和你的站点统一，提升用户体验
• 定期查看wp-content/debug.log（如果开启了的话），排查潜在问题
• 避免错误循环：自定义错误页面本身不能有错误，否则会一直显示错误内容，建议用纯HTML或者确保WordPress错误页的代码没有问题

内容的提问来源于stack exchange，提问作者Raxit