CodeIgniter中mysqli::real_connect()连接错误的解决及原因排查

问题定性 #

这个错误不属于编码问题，完全是服务器/网络层面的故障。getaddrinfo failed是PHP调用系统DNS解析函数时失败导致的，说明PHP无法将你配置的数据库主机名（比如db.example.com）解析为对应的IP地址。非频繁出现的特点，意味着是间歇性DNS解析故障，可能是DNS服务器不稳定、网络链路波动或本地DNS缓存失效导致的。

解决方法 #

• 替换数据库主机名为IP地址：打开CodeIgniter的application/config/database.php配置文件，将$db['default']['hostname']的值从域名直接改成数据库服务器的真实IP地址，彻底绕开DNS解析步骤，从根源避免解析失败问题。
• 检查并更换DNS服务器：查看服务器的DNS配置（Linux系统看/etc/resolv.conf，Windows系统看网络适配器的DNS设置），如果当前使用的DNS服务器不稳定，换成公共可靠的DNS（如8.8.8.8、114.114.114.114）。
• 配置本地DNS缓存：在服务器上部署本地DNS缓存服务（比如Linux的dnsmasq），将常用域名的解析结果缓存到本地，减少对外部DNS的依赖，提升解析稳定性。
• 调整数据库连接超时：在database.php中添加连接超时配置，比如$db['default']['connect_timeout'] = 10;，给DNS解析和数据库连接过程增加缓冲时间，降低间歇性故障的触发概率。
• 排查数据库服务器网络：确认数据库服务器的网络链路是否存在间歇性中断，或者主机名是否存在解析记录波动的情况（比如DNS记录更新未同步）。

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