CodeIgniter应用仅单个模块出现数据库连接错误调试求助

这种“其他模块正常，唯独单个模块报数据库连接失败”的问题，核心矛盾点在于相同全局配置下模块级别的差异，结合你的环境（Linux + MySQL 5 + PHP 7 + Apache 2），我整理了几个优先级从高到低的调试方向：

1. 优先检查模块是否重载了数据库配置 #

从错误文件core/Loader.php来看，你的应用大概率是基于CodeIgniter框架。这类框架支持模块级的配置覆盖：

• 查看该模块目录下是否存在单独的配置文件：application/modules/[你的模块名]/config/database.php，如果有，对比里面的hostname、username、password、database是否和全局配置一致，有没有拼写错误或过时的凭据。
• 检查模块的控制器/模型代码，是否存在手动指定数据库连接的逻辑，比如：

  $custom_db_config = array(
      'hostname' => 'wrong-host',
      'username' => 'wrong-user',
      // ... 其他错误配置
  );
  $this->load->database($custom_db_config, TRUE);
  

  这种自定义连接会绕过全局配置，很容易导致错误。

2. 定位错误发生时的实际配置参数 #

直接去core/Loader.php第338行附近加调试代码，输出当前正在使用的数据库配置，对比全局配置找差异：

// 在Loader.php第338行前插入
echo "当前数据库配置：<br>";
var_dump($this->db->hostname, $this->db->username, $this->db->database);
exit;

运行模块后看输出，就能知道是不是配置参数被篡改了——比如某些模块逻辑修改了全局配置变量，或者加载了错误的连接组（比如用了$db['test']而不是$db['default']）。

3. 排查模块的运行环境差异 #

虽然全局环境正常，但单个模块可能有特殊的运行上下文：

• 检查模块目录下的.htaccess文件，是否有修改PHP环境变量的规则（比如php_value mysql.default_host localhost），覆盖了全局php.ini的配置。可以在模块入口文件里输出phpinfo()，和正常模块的phpinfo()对比，重点看MySQL相关的配置项（mysqli.default_host、mysqli.default_port等）。
• 检查文件权限：模块的配置目录/文件是否允许Apache进程用户（通常是www-data、apache）读取？如果模块的权限比全局配置目录严格（比如权限是600而全局是644），会导致配置无法加载，框架只能用默认的错误参数尝试连接。

4. 从MySQL端排查连接问题 #

用全局配置的凭据在服务器命令行测试连接，确认MySQL端的权限没问题：

mysql -u [你的用户名] -p[你的密码] -h [数据库主机] [数据库名]

如果命令行能正常连接，再检查MySQL的日志：

• 查看MySQL错误日志（通常在/var/log/mysql/error.log或/var/lib/mysql/[hostname].err），看有没有该模块连接时的错误记录（比如“Access denied”、“Too many connections”）。
• 用mysqladmin status或SHOW GLOBAL STATUS LIKE 'Threads_connected';查看当前连接数，确认是否达到了max_connections限制——如果该模块短时间发起大量连接，可能触发阈值。

5. 清理框架缓存排除缓存问题 #

如果是CodeIgniter框架，检查是否开启了配置缓存（application/config/config.php中的$config['config_cache_path']）。如果缓存文件中的数据库配置是旧的，且只有该模块加载了缓存，就会导致连接失败：

• 直接清空application/cache/目录下的所有缓存文件，然后重新测试模块，看是否恢复正常。

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