裸连测试是排查mysql连接问题的第一步：用test_db.php执行mysqli_connect直连，若失败则属环境配置问题（如服务未启、权限不足、扩展未开），成功则问题在框架配置；重点检查hostname是否误用localhost、数据库名/用户名是否缺cpanel前缀、dbdriver是否配错（ci3用mysqli，ci4用mysqli）；mysql 8.0+需处理caching_sha2_password兼容性，用户须显式授权绑定数据库。
连不上 MySQL，八成不是代码写错了，而是配置、环境、驱动三者没对齐。别急着改 model 或重写 query，先从最底层确认能不能通——很多问题根本没走到框架逻辑里就卡死了。
第一步：裸连测试，绕过框架直接验基础
新建一个 test_db.php 文件，内容就这几句：
（把下面的值替换成你 .env 或 database.php 里填的）<?php <br>$conn = mysqli_connect("127.0.0.1", "your_user", "your_pass", "your_db");<br>if (!$conn) {<br> die("连接失败: " . mysqli_connect_error());<br>}<br>echo "连接成功！";<br>mysqli_close($conn);<br>?>
上传到网站根目录直接访问。结果分两种：
- 显示“连接失败” → 问题在服务器环境：账号密码错、库不存在、用户没授权、MySQL 没运行，或 PHP 没开 mysqli 扩展
- 显示“连接成功” → 问题在 CI 配置或加载环节，继续往下查
第二步：重点核对三个高频错误点
80% 的连接失败都出在这三处，尤其部署到共享主机（如 Namecheap）时几乎必踩：
- hostname 写成了 localhost：Linux 下它强制走 Unix socket，但 PHP 常找不到 sock 文件。改成 127.0.0.1 强制走 TCP，基本立竿见影
- 数据库名/用户名漏了前缀：Namecheap、GoDaddy 等主机自动加 cPanel 用户名前缀（如 abc123_mydb），不能直接用本地短名
-
dbdriver 配错：CI4 不再支持
mysql，必须用MySQLi或PDO；CI3 虽兼容 mysql，但 PHP 7+ 已移除该扩展，务必改用mysqli
第三步：按版本查配置位置和写法
CI3 看 application/config/database.php，确认以下五项全对：
-
$db['default']['hostname']是 IP 或 127.0.0.1（非 localhost） -
$db['default']['username']和$db['default']['password']与 MySQL 实际一致（空密码写""） -
$db['default']['database']是已存在且授权过的库名 -
$db['default']['dbdriver']设为mysqli（CI3）或MySQLi（CI4，大小写敏感） -
$active_group = 'default';这行没被注释、没拼错
CI4 看 app/Config/Database.php 或 .env，关键字段：
database.default.hostname = "127.0.0.1"-
database.default.database = "abc123_mydb"（带前缀！） -
database.default.DBDriver = "MySQLi"（注意大小写） - 若用 PDO，必须补全
database.default.DSN = "mysql:host=127.0.0.1;dbname=abc123_mydb;charset=utf8mb4" - 改完执行
php spark cache:clear，否则缓存旧配置
第四步：别忽略 MySQL 8.0+ 和权限细节
如果裸连成功但 CI 仍报错，可能是认证协议不兼容：
- MySQL 8.0 默认用
caching_sha2_password，老版 PHP 不支持 → 登录 MySQL 执行：ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; - 用户建好了，但没绑定到库 → 进 cPanel「MySQL Databases」→「Add User To Database」→ 手动关联并勾选 SELECT/INSERT/UPDATE/DELETE 权限
- 本地开发用 root，线上千万别用 root → 创建专用用户，并限制 Host 为
%或具体 IP
