WordPress随机数据库连接错误，如何定位异常脚本/插件？

错误本质 #

user XXXX already has more than 'max_user_connections' active connections 说明数据库分配给当前用户的并发连接数已达上限，根源是WordPress中存在未正确释放数据库连接、重复发起连接或高并发查询的脚本/插件/代码。

排查步骤 #

1. 开启数据库连接追踪日志 #

在MySQL配置中开启general_log，记录所有数据库连接请求：

• 临时开启（无需重启MySQL）：

  SET GLOBAL general_log = 'ON';
  SET GLOBAL general_log_file = '/var/log/mysql/connections.log';
  

• 查看日志时，重点关注重复发起连接的进程ID（PID），对应到服务器上的PHP进程，进而追踪到WordPress的请求来源。
• 排查完成后记得关闭日志：SET GLOBAL general_log = 'OFF';

2. 用WordPress调试日志追踪高查询请求 #

修改wp-config.php，添加调试代码记录异常查询的调用栈：

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

add_action('shutdown', function() {
    global $wpdb;
    // 设定查询次数阈值，比如超过100次则记录调用栈
    if ($wpdb->num_queries > 100) {
        $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS);
        error_log("[High Query Count] {$wpdb->num_queries} queries from:\n" . print_r($backtrace, true));
    }
});

查看wp-content/debug.log，找到触发高查询的文件路径和函数，定位嫌疑代码。

3. 逐个排查插件与主题 #

• 先禁用所有插件，刷新网站观察是否还出现错误。若恢复正常，再逐个启用插件，每启用一个观察10-15分钟，直到错误重现，该插件即为主要嫌疑对象。
• 若禁用插件后仍有错误，切换到WordPress默认主题（如Twenty Twenty-One），测试是否由主题代码导致。

4. 检查自定义代码与脚本 #

• 检查主题的functions.php、自定义插件文件，寻找以下问题：
  • 循环中重复执行数据库查询且未优化
  • 使用原生MySQL函数（如mysqli_connect）但未调用mysqli_close释放连接
  • 未使用WordPress自带的$wpdb类，导致连接未被统一管理

5. 排查定时任务（WP Cron） #

• 使用WP-CLI命令列出所有定时任务：

  wp cron event list
  

• 逐个禁用可疑任务（如wp cron event delete <hook_name>），观察错误是否消失，定位持续占用连接的定时任务。

注意事项 #

• 生产环境调试尽量在低峰期进行，或搭建 staging 环境复现问题
• 开启数据库日志后，需及时关闭避免占用过多磁盘空间

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