CodeIgniter框架数据库连接报错_CodeIgniter框架DB配置常见问题解答【解答】
CodeIgniter数据库报错“Unabletoconnecttoyourdatabaseserver”多因配置与环境不匹配。应检查hostname用127.0.0.1替代localhost，区分socket与TCP/IP错误。CI3需mysqli驱动，CI4用PDO，并确认扩展启用。账号问题用命令行测试权限与主机。
在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' 实际上是两个完全不同的账号，这点一旦忽略，排查起来会相当折腾。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
