为什么WordPress开启调试配置后仍不生成debug日志也不输出错误？

核心原因 #

• WordPress 5.2及以上版本内置的致命错误保护机制会拦截PHP错误输出，触发时直接返回「此网站出现严重错误」提示，优先级高于自定义的WP_DEBUG配置
• 日志目录/文件权限不足，web服务器运行用户（如apache、www-data）无写入权限，无法生成debug日志
• 自定义错误配置加载顺序错误，代码执行到配置项前就已抛出致命错误
• php.ini中disable_functions禁用了error_reporting、ini_set方法，自定义配置未生效
• PHP全局错误日志路径配置无效，无写入权限导致错误被吞

排查步骤 #

1. 优先绕过WordPress致命错误保护
   在wp-config.php文件**最顶部（所有代码之前）**添加如下配置，不要嵌套在原有判断逻辑中：

define( 'WP_DISABLE_FATAL_ERROR_HANDLER', true );
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', true );
error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);

配置后刷新页面即可看到具体错误信息。

2. 校验日志权限与PHP配置有效性
   在站点根目录新建test.php文件，写入如下内容：

<?php
phpinfo();
?>

访问该文件查看配置：

• 搜索disable_functions，确认error_reporting、ini_set未被禁用
• 搜索error_log，确认配置的路径存在，且web运行用户有写入权限
• 手动在wp-content目录下创建debug.log文件，设置权限为755，所有者修改为web运行用户（示例命令：chown www-data:www-data wp-content/debug.log）

3. 分层定位错误来源

• 重命名wp-content/plugins目录为plugins-bak，禁用所有插件，若恢复访问则逐个还原插件定位问题项
• 若禁用插件无效，重命名当前使用的主题文件夹（路径为wp-content/themes/你的主题名），WordPress会自动回退到默认主题，排查是否为主题代码问题
• 若以上操作均无效，重新上传WordPress官方核心文件（不要覆盖wp-content目录和wp-config.php），排除核心文件损坏问题

4. 查看Apache全局错误日志
   若以上操作仍未拿到错误信息，直接查看Apache运行日志，默认路径为/var/log/apache2/error.log（不同发行版路径有差异），未被业务层捕获的PHP致命错误都会输出到该日志中。

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