数据库连接超时导致codeigniter报错，需通过裸连测试确认问题，调整php和mysql超时参数，启用持久连接，添加健康检查中间件，并部署监控看板定位瓶颈。
CodeIgniter应用在高并发或网络不稳定时突然报“Database Error: Unable to connect to your database server”，页面卡死几秒后才显示错误——这通常是数据库连接超时导致的，不是配置写错，而是连接建立过程被阻塞或等待过久。
确认是否真为连接超时而非配置错误
先排除低级误判：在控制器中插入一段裸连测试代码，绕过CI框架加载逻辑，直连验证。
复制以下代码到任意控制器方法中（如index()），访问该路由：
$link = @mysqli_connect('127.0.0.1', 'root', '', 'test', 3306);
if (!$link) {
echo '原始连接失败：' . mysqli_connect_error() . '（耗时：' . (microtime(true) - $_SERVER['REQUEST_TIME_FLOAT']) . 's）';
exit;
}
echo '裸连成功，耗时：' . (microtime(true) - $_SERVER['REQUEST_TIME_FLOAT']) . 's';
若裸连也卡顿超过5秒才报错，说明是网络层或MySQL服务层超时；若裸连瞬间失败且报错明确（如Access denied），则问题不在超时，应退回检查账号权限或hostname拼写。
调整PHP与MySQL底层连接参数
超时根源常藏在PHP驱动和MySQL服务端握手阶段。需同步修改两端设置：
① 修改php.ini中的MySQL连接超时值（非CI配置文件）：
【必须重启PHP-FPM或Apache】否则修改不生效。找到并修改三处：
mysqli.connect_timeout = 10
pdo_mysql.default_socket_timeout = 10
default_socket_timeout = 10
② 登录MySQL服务器，执行命令调大服务端等待阈值：
SET GLOBAL connect_timeout = 30;（临时生效，重启MySQL会还原）
③ 若使用云数据库（如阿里云RDS、腾讯云CDB），【必须在控制台白名单中放行应用服务器IP，并确认安全组已开放3306端口】——很多“超时”实际是防火墙静默丢包，连接请求发不出去，自然等满超时才报错。
优化CodeIgniter数据库配置启用持久连接
频繁创建新连接会加剧超时风险，尤其在短连接模式下。开启持久连接可复用已有TCP通道：
打开application/config/database.php，定位到$db['default']数组，将pconnect设为TRUE：
'pconnect' => TRUE,
注意：【pconnect开启后，MySQL的wait_timeout值必须大于PHP脚本执行最大时长，否则连接池中的空闲连接会被MySQL主动断开，下次复用时触发重连超时】。建议将MySQL的wait_timeout设为600（10分钟），CI端保持默认即可。
这一步操作起来很简单，直接改完保存，无需清缓存或重启服务，下次请求自动生效。
引入连接健康检查中间件
当数据库偶发抖动时，被动等待不如主动探测。在CI 3.x中，可在application/core/MY_Model.php基类中加入连接保活逻辑：
方法一：每次查询前轻量探测
在get()、insert()等方法开头添加：
if (!$this->db->conn_id || !$this->db->simple_query('SELECT 1')) { $this->db->reconnect(); }
方法二：定时后台探活（推荐用于关键业务）
新建application/libraries/DbHealthChecker.php，内容如下：
class DbHealthChecker { public function check() { return ($this->ci->db->simple_query('SELECT 1')) ? 'OK' : 'FAIL'; } }
在主控制器构造函数中加载：$this->load->library('dbhealthchecker');，再在关键操作前调用$this->dbhealthchecker->check()判断状态。
这能避免因单次连接中断导致整个事务失败，把超时拦截在业务逻辑之外。
部署连接监控看板快速定位瓶颈
单纯调参治标不治本。用InsCode（快马）平台预置模板一键生成数据库连接实时看板：
登录InsCode → 左侧导航选「运维监控」→ 点击「数据库连接监测系统」模板 → 填写MySQL连接串（host/port/user/pass/db）→ 点击「项目生成」按钮 → 等待生成完成 → 浏览器打开预览地址。
看板自动显示当前活跃连接数、平均获取连接耗时、超时告警计数。若发现「acquireTimeout > 1s」持续出现，说明连接池已饱和，需立即扩容maxActive参数或加机器。
