手把手后端日志实战教程：手把手打造企业级项目

既然涉及到底层排查，那我们就直接上服务器运维最硬核的手段。在 WordPress 开发中，后端日志主要分为 WordPress 自身的 PHP 调试日志 和 服务器环境日志 两个层面。

以下是手把手的实操指南：

第一步：开启 WordPress 核心调试日志

这是排查插件冲突、主题代码报错最直接的工具。通过 SSH 或 SFTP 连接到服务器，编辑网站根目录下的 wp-config.php 文件。

在 /* That's all, stop editing! */ 这一行上方，加入以下代码：

php

编辑

1define('WP_DEBUG', true); // 开启调试模式

2define('WP_DEBUG_LOG', true); // 将错误写入日志文件

3define('WP_DEBUG_DISPLAY', false); // 禁止在前端页面直接显示错误(生产环境必须关闭)

4@ini_set('display_errors', 0); // 双重保险，防止 PHP 错误泄露

保存后，触发一下网站的报错页面。随后进入 /wp-content/ 目录，你会发现生成了一个 debug.log 文件。用 tail -f /wp-content/debug.log 可以实时监控日志输出，精准定位到具体的报错文件和行号。

第二步：排查服务器环境日志

如果网站直接 502 Bad Gateway 或彻底白屏，连 debug.log 都不生成，说明问题出在服务器底层(如 PHP 进程崩溃、内存溢出)。

Nginx/Apache 日志：通常在 /var/log/nginx/error.log 或 /var/log/apache2/error.log。这里会记录 PHP-FPM 连接失败、权限拒绝等底层错误。

PHP 全局日志：检查 php.ini 中的 error_log 路径配置。如果 wp-config.php 里的日志没写进去，可能是 PHP 底层直接报错被拦截了。

第三步：高阶运维排查技巧

数据库查询分析：如果网站加载极慢，可以在 wp-config.php 中加入 define('SAVEQUERIES', true);。这会将所有 SQL 查询记录在内存中，配合 Query Monitor 插件或直接在代码里打印 $wpdb->queries，能迅速揪出拖慢后端的“慢查询”。

命令行排查：如果后台彻底进不去，可以使用 WP-CLI 工具。通过 SSH 执行 wp plugin deactivate --all 或 wp core verify-checksums，能在不依赖前端界面的情况下快速排查核心文件损坏或插件冲突。