CodeIgniter框架数据库连接报错_CodeIgniter框架DB配置常见问题解答【解答】

在CodeIgniter开发中遇到“Unable to connect to your database server”这个报错，十有八九不是代码本身的问题，而是配置与运行环境之间的“默契”没对上。

数据库连接报错提示“Unable to connect to your database server”

首先得检查 $db['default']['hostname'] 这个配置项。本地开发时大家习惯写 'localhost'，但很多Linux服务器——尤其是通过socket连接MySQL的那种——实际需要改成 '127.0.0.1'。为什么？因为 localhost 会强制PHP走Unix socket，而 127.0.0.1 才会走TCP/IP协议。

不同报错信息指向的问题也各不相同：

• 出现 mysqli::real_connect(): (HY000/2002): No such file or directory → 说明PHP尝试连接socket文件失败，要么路径不对，要么mysqld服务没启动
• 出现 Connection refused → MySQL服务压根没跑起来，或者它只绑定了非127.0.0.1的地址（比如只监听内网IP）
• 本地能连、上线连不上 → 多半是数据库账号没有远程访问权限，得去检查 GRANT 语句里是否包含 'user'@'%' 或对应的域名/IP

调试时加 print_r($db['default']) 没反应？

这个情况很常见——因为CodeIgniter在加载数据库之前就已经报错了，写在 database.php 文件末尾的调试代码根本没机会执行。真正的断点应该在 system/database/DB_driver.php 的 connect() 方法里。更直接的做法是：在 application/config/database.php 最顶部插入这样一段代码：

if (PHP_SAPI !== 'cli') {
    header('Content-Type: text/plain');
    error_log(print_r($_SERVER, true), 3, '/tmp/ci-db-debug.log');
    die('DB config loaded, check /tmp/ci-db-debug.log');
}

这样一来，可以绕过框架的整个初始化流程，第一时间确认配置是否被正确读取。

mysql_connect() 报错 “No such file or directory”

这是旧版CodeIgniter 2.x遗留下来的典型问题。PHP 7.0+ 已经彻底移除了 mysql_* 函数，只要调用了就会直接崩溃。千万别手动补写 mysql_connect() 来调试——那只会让你在错误的路上越走越远。

正确的处理方式：

• 确认自己在用哪个版本：CI3默认用 mysqli，CI4强制用 PDO
• CI3下检查 $db['default']['dbdriver'] 必须是 'mysqli'，不是 'mysql'
• CI4下看 app/Config/Database.php 中 $default->DBDriver 是否为 'MySQLi' 或 'PDO'，同时确认对应的PHP扩展已启用（用 php -m | grep -i mysqli 验证）
• 如果服务器只装了 pdo_mysql 但没装 mysqli，CI3会静默降级失败，必须显式指定驱动

数据库账号密码没错，还是连不上

别急着反复改配置，先用命令行手工验证一下连接是否真的通畅。在服务器上执行：

mysql -h $HOST -u $USER -p$PASS -D $DBNAME（注意 -p 和密码之间不能有空格）

如果命令行也连不上，那问题一定出在权限或服务端配置上：

• MySQL用户权限还没刷新：执行 FLUSH PRIVILEGES;
• host白名单限制太严格：用 SELECT host,user FROM mysql.user; 查看账号绑定的host是 localhost、127.0.0.1 还是 %
• SELinux或防火墙拦截：可以临时关闭试试，setenforce 0 和 systemctl stop firewalld
• MySQL配置了 skip-networking 或 bind-address = 127.0.0.1，但没有开放远程端口

实际生产环境中，最容易被忽略的一点就是：MySQL用户host字段和PHP连接时使用的hostname必须精确匹配。'user'@'localhost' 和 'user'@'127.0.0.1' 实际上是两个完全不同的账号，这点一旦忽略，排查起来会相当折腾。