WordPress 如何查看插件冲突日志文件 debug.log 具体路径

文章导读
WordPress 的 debug.log 文件默认不存在,开启调试模式后具体路径为网站根目录下的 wp-content/debug.log。
📋 目录
  1. 快速处理思路
  2. 为什么会这样
  3. 分步处理
  4. 怎么验证是否生效
  5. 常见坑
  6. 常见问题
  7. 参考来源
A A

WordPress 的 debug.log 文件默认不存在,开启调试模式后具体路径为网站根目录下的 wp-content/debug.log。

先说结论:必须手动在 wp-config.php 中开启调试常量,日志才会生成到 wp-content 目录。

  • 先确认:检查 wp-config.php 是否定义了 WP_DEBUG 常量。
  • 先处理:添加 WP_DEBUG_LOG 常量指向 wp-content/debug.log。
  • 再验证:触发一个警告并检查文件是否写入。

快速处理思路

不需要命令行,直接编辑网站根目录的 wp-config.php 文件即可启用日志。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

将上述代码放入 wp-config.php 的 require_once(ABSPATH . 'wp-settings.php'); 之前。

为什么会这样

WordPress 默认关闭调试日志是为了生产环境安全,防止敏感信息泄露。

开启后 PHP 错误、警告和通知会被捕获并写入指定文件,帮助定位插件或主题代码问题。

分步处理

通过 FTP 或主机文件管理器找到 wp-config.php,备份后编辑。

WordPress 如何查看插件冲突日志文件 debug.log 具体路径

1. 查找是否已有 WP_DEBUG 定义,若有则修改,若无则新增。

2. 确保 WP_DEBUG_LOG 设置为 true,默认路径即为 wp-content/debug.log。

3. 设置 WP_DEBUG_DISPLAY 为 false,避免错误直接显示在页面上。

4. 保存文件并上传覆盖原文件。

怎么验证是否生效

访问网站后台或前台触发一个已知警告,检查 wp-content 目录下是否生成 debug.log。

查看文件修改时间是否为最新,且文件大小不为 0。

打开文件确认是否有 PHP Warning 或 Notice 记录。

WordPress 如何查看插件冲突日志文件 debug.log 具体路径

常见坑

调试完成后忘记关闭 WP_DEBUG,可能导致日志文件过大或泄露路径信息。

文件权限设置错误导致 WordPress 无法写入日志,需确保 wp-content 目录可写。

部分主机商禁止开启 WP_DEBUG,需先确认主机环境支持。

常见问题

debug.log 文件在哪里?

默认位于网站根目录的 wp-content 文件夹内。

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

轻微影响 I/O 性能,建议排查完成后立即关闭。

日志文件太大怎么办?

手动清空文件内容或关闭调试模式后删除该文件。

参考来源

  • WordPress.org, Debugging in WordPress, https://wordpress.org/documentation/article/debugging-in-wordpress/