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,备份后编辑。
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 记录。
常见坑
调试完成后忘记关闭 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/