codeigniter 连不上远程数据库的根源是远程数据库白名单未添加当前出口ip。需登录控制台配置白名单、确认真实出口ip、检查ci配置(如hostname勿用localhost、.env位置正确),并注意mysql 8.0认证兼容性等问题。

CodeIgniter 连不上远程数据库,提示“host not allowed”或“Access denied for user... using password YES”,本质不是框架问题,而是远程数据库服务端明确拒绝了你的连接请求——它没把你当前的出口 IP 加入白名单。
确认远程数据库是否开启白名单机制
多数云数据库(如阿里云 RDS、腾讯云 CDB、AWS RDS、Neon、PlanetScale)默认关闭公网访问,或强制启用 IP 白名单。本地开发环境直连失败,大概率是这个环节卡住了。
- 登录数据库控制台,找到「白名单设置」「安全组」或「Network Access」页面
- 检查是否已添加你当前公网 IP(不是内网 IP,也不是 127.0.0.1)
- 注意:动态宽带用户 IP 会变,可临时加一段 CIDR(如 203.123.45.0/24),或用“0.0.0.0/0”测试(仅限调试,切勿长期保留)
- 某些服务商(如 Neon)不支持传统 IP 白名单,只允许通过 Endpoint 域名访问,此时需确保你用的是完整连接串里的 host,且 SSL Mode 设为 require
验证你的出口 IP 是否真实有效
你以为的“本机 IP”可能根本不是数据库看到的源地址:
- 公司网络常走代理或 NAT,实际出口 IP 是网关设备的公网 IP,不是你电脑的局域网地址
- 用浏览器打开 https://api.ipify.org 查看当前真实出口 IP
- 如果在 Docker 或 WSL 中运行 CI,出口 IP 是宿主机的公网 IP,不是容器内网地址
- 部分云主机(如 Namecheap 共享主机)对外统一出口 IP,需联系客服确认该 IP 段是否已被加入白名单
绕过白名单限制的临时方案(仅限调试)
当无法及时获取或修改白名单时,可用以下方式快速验证是否为白名单导致:
- 写一个独立 PHP 文件(如 test_remote.php),用原生 mysqli 或 PDO 连接,内容与 CI 配置一致,上传到和 CI 同一服务器执行——若能连通,说明是 CI 配置或路径问题;若也失败,则确认是网络层拦截
- 使用 SSH 隧道本地端口转发:
ssh -L 3307:remote-db-host:3306 user@jump-server,然后把 CI 的 hostname 改成 127.0.0.1、port 改为 3307,相当于“借道跳板机”绕过白名单 - CI4 用户可临时改用 Socket 连接(仅限同机部署):将 hostname 设为空字符串 '',并指定 unix_socket 路径(需数据库支持且路径正确)
CI 配置中容易被忽略的细节
即使白名单开了,CI 仍可能因配置错位而报类似错误:
- CI4 的 .env 文件必须放在项目根目录(与 public 同级),且不能被 web 服务器直接访问(Apache/Nginx 需屏蔽 .env)
- hostname 别写 localhost —— 远程数据库环境下它会被解析为本地回环,应明确写目标 IP 或域名(如 rm-xxx.mysql.rds.aliyuncs.com)
- MySQL 8.0+ 用户若用 caching_sha2_password 认证,旧版 PHP 可能握手失败,需在数据库侧执行:
ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pwd'; - 多库场景下,CI3 必须用
$this->load->database('name', TRUE)显式返回实例;CI4 则需在 .env 中为不同库定义完整配置段,并用Database::connect('name')











