WordPress 调试模式开启后怎么查看插件冲突详细日志

文章导读
开启 WordPress 调试模式后,插件冲突日志通常记录在 wp-content 目录下的 debug.log 文件中,需要在 wp-config.php 中配置 WP_DEBUG_LOG 常量。生产环境严禁开启 WP_DEBUG_DISPLAY,避免向访客暴露站点路径和错误信息。
📋 目录
  1. 命令速用版
  2. 为什么会这样
  3. 分步处理
  4. 怎么验证是否生效
  5. 常见坑
  6. 常见问题
  7. 参考来源
A A

开启 WordPress 调试模式后,插件冲突日志通常记录在 wp-content 目录下的 debug.log 文件中,需要在 wp-config.php 中配置 WP_DEBUG_LOG 常量。生产环境严禁开启 WP_DEBUG_DISPLAY,避免向访客暴露站点路径和错误信息。

先说结论:调试模式本身不直接标记“插件冲突”,而是记录 PHP 错误堆栈,需通过日志中的文件路径定位冲突插件。

  • 先确认站点环境是否为 staging 或已做完整备份
  • 先处理 wp-config.php 配置,确保只写入日志不显示错误
  • 再验证 debug.log 内容,根据文件路径排查具体插件

命令速用版

在 wp-config.php 文件的 /* That's all, stop editing! Happy publishing. */ 上方添加以下配置:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

为什么会这样

WordPress 核心没有内置的“插件冲突扫描器”,调试模式依赖 PHP 的错误报告机制。

开启 WP_DEBUG 后,PHP 会将警告、notice 和致命错误捕获并写入指定文件,插件冲突本质是 PHP 代码执行错误,因此会留痕在日志中。

分步处理

1. 备份站点:操作前通过主机面板或插件备份全站文件及数据库。

2. 编辑配置:使用 SFTP 或文件管理器打开根目录下的 wp-config.php。

3. 写入常量:将上述代码片段粘贴到指定位置,保存文件。

4. 复现错误:在前台或后台触发导致站点异常的操作。

5. 查看日志:检查 wp-content/debug.log 文件最新内容。

6. 关闭调试:排查结束后,将 WP_DEBUG 改回 false 或删除相关行。

WordPress 调试模式开启后怎么查看插件冲突详细日志

怎么验证是否生效

检查 wp-content 目录下是否生成 debug.log 文件,且文件修改时间与你复现错误的时间一致。

打开日志文件,搜索包含 wp-content/plugins/ 的行,确认报错文件属于哪个插件文件夹。

常见坑

1. 日志文件过大:长期开启调试模式会导致 debug.log 占用大量磁盘空间,需定期清理。

2. 权限问题:如果 wp-content 目录不可写,日志文件无法生成,需检查文件夹权限是否为 755 或 775。

3. 错误暴露:WP_DEBUG_DISPLAY 设为 true 会让错误直接显示在页面上,生产环境必须设为 false。

常见问题

debug.log 文件在哪里?

默认位于网站根目录的 wp-content 文件夹内,完整路径通常是 /public_html/wp-content/debug.log。

开启调试模式会影响网站速度吗?

会有轻微影响,因为系统需要额外写入日志文件,建议排查完成后立即关闭。

日志文件是空的怎么办?

检查 wp-content 目录写入权限,或确认错误是否达到了 PHP 记录的错误级别。

参考来源

WordPress.org - Debugging in WordPress: https://wordpress.org/support/article/debugging-in-wordpress/