CodeIgniter连接远程数据库需正确配置hostname、username、password等参数，并确保远程数据库监听0.0.0.0、用户授权允许指定IP访问、防火墙及安全组放行对应端口；代码中手动加载并调用initialize()验证连接。
CodeIgniter 连接远程服务器数据库，核心是把远程数据库的访问参数正确填入配置，并确保网络与权限层面允许连接。它和本地连接在代码上几乎一样，差别全在配置值和外部条件。
配置远程数据库连接参数
打开 application/config/database.php，修改或新增一个数据库组（比如 $db['remote']['hostname']），关键项如下：
-
hostname：填远程数据库服务器的公网 IP 或可解析的域名（如
123.45.67.89或db.example.com），不能写localhost - username 和 password：必须是远程数据库中已授权、且允许从你 Web 服务器 IP 登录的账号
- database：远程服务器上已创建的目标数据库名
-
dbdriver：如
mysqli（MySQL/MariaDB）或postgre（PostgreSQL） -
port：若远程数据库未使用默认端口（MySQL 默认 3306，PostgreSQL 默认 5432），需显式指定，例如
$db['remote']['port'] = '3307'; -
db_debug：开发时建议设为
TRUE，便于快速看到连接失败的具体错误
确认远程数据库服务允许外部访问
仅配对参数还不够，以下三点必须同时满足：
- 远程数据库服务（如 MySQL）需监听所有网卡，而非仅
127.0.0.1。检查其配置文件（如 MySQL 的my.cnf中bind-address = 0.0.0.0） - 远程数据库用户必须有从你的 Web 服务器 IP（不是
%时）登录的权限，例如执行：GRANT ALL ON your_db.* TO 'user'@'203.0.113.45' IDENTIFIED BY 'pass'; FLUSH PRIVILEGES; - 远程服务器防火墙（如 iptables、ufw）及云平台安全组（如阿里云/腾讯云的安全组规则）需放行对应数据库端口（如 TCP 3306）
在代码中加载并测试远程连接
不依赖自动加载，用手动方式加载并验证是否真正连通：
$this->load->database('remote', TRUE); // 加载 remote 组，返回 DB 实例
if ($this->db->conn_id && $this->db->initialize()) {
echo "远程数据库连接成功";
} else {
echo "连接失败，请检查配置或网络";
}
注意：$this->db->conn_id 存在只说明对象已创建，initialize() 才真正尝试握手；若仍报错，查看 PHP 错误日志或开启 db_debug 获取底层提示（如 “Connection refused”、“Access denied”、“Timeout”）。
常见失败原因速查
- Connection timed out → 网络不通，检查防火墙、安全组、DNS 解析、远程服务是否运行
- Access denied for user → 用户权限不足或密码错误，确认授权语句中的 host 是否匹配你的来源 IP
-
Host 'x.x.x.x' is not allowed to connect → MySQL 用户 host 设置为
localhost，需改为具体 IP 或%（生产环境慎用） -
SSL requirement failed → 某些云数据库强制 SSL，CI3 默认不启用，需在配置中加
'encrypt' => TRUE并配置证书路径（较复杂，建议先关闭 SSL 要求测试）
