数据库连接失败主因是参数错误、扩展未启用、版本不兼容、连接池耗尽、防火墙拦截及框架配置干扰，需逐层排查环境、配置、权限与服务状态。
数据库连接参数写错是最常见的原因
绝大多数“连不上”问题，其实根本没走到驱动层，而是 PDO 或 mysqli 初始化阶段就报错了。比如 Laravel 的 .env 里写成 DB_HOST=localhsot（少了个 t），或者 Symfony 的 doctrine.yaml 中把端口写成 port: "33060"（实际是 3306）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用命令行直连验证：
mysql -h DB_HOST -P DB_PORT -u DB_USER -p DB_NAME，能通再查框架配置 - 检查框架是否读取了正确的环境文件——Laravel 默认只读
.env，但若设置了APP_ENV=production且没生成配置缓存，可能跳过它 -
DB_PASSWORD含特殊字符（如@、/、:）时，必须 URL 编码后填入 DSN；Laravel 的config/database.php中mysql驱动的url字段尤其容易在这里出错
PHP 扩展未启用或版本不兼容
哪怕参数全对，pdo_mysql 没开也白搭。常见现象是报错：Class 'PDO' not found 或 Driver not found: mysql。注意：PHP 8.2+ 已移除 mysql 扩展（非 mysqli），而某些老教程还在教用 mysql_connect()。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep -i pdo确认pdo和pdo_mysql都在列表中 - Docker 环境下常漏掉扩展安装步骤，例如 Alpine 镜像需额外执行：
apk add php82-pdo_mysql（版本号要匹配） - Laravel 10+ 要求 PHP ≥ 8.1，若用 PHP 7.4 连 MySQL 8.0+，可能因默认认证插件（
caching_sha2_password）不兼容而静默失败——此时需在 MySQL 侧执行：ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'password';
连接池耗尽或超时被防火墙拦截
开发时连得好好的，上线后隔几分钟就报 SQLSTATE[HY000] [2002] Connection refused，大概率不是配置问题，而是连接没释放、被复用或被中间设备断开。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查是否在循环里反复调用
new PDO()却没unset()或null掉对象——PDO 实例不会自动 close，长连接会撑爆 MySQL 的max_connections - MySQL 默认
wait_timeout=28800（8 小时），但云服务商（如阿里云 RDS）可能设为 300 秒；框架若没配options => [PDO::ATTR_TIMEOUT => 5]，空闲连接会被服务端先断，下次用就报错 - 本地测试通、线上不通？查安全组和 SELinux：CentOS 7+ 默认开启 SELinux，可能阻止 Apache/PHP-FPM 访问网络，临时关掉验证：
setenforce 0
框架自身连接管理逻辑干扰
有些框架（如 ThinkPHP 6）默认开启连接池，而另一些（如 CodeIgniter 4）在 CLI 模式下会重用连接但不检测存活状态，导致“前一次请求成功，下一次就挂”。更隐蔽的是 ORM 层的懒加载触发时机问题——你以为没查库，其实 $user->posts 已悄悄发起连接。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在入口加诊断代码：Laravel 可用
DB::connection()->getPdo()看是否返回 PDO 实例；ThinkPHP 用Db::getConnect()判断连接对象是否存在 - 禁用所有中间件和事件监听器，最小化启动流程，排除第三方包干扰（比如某日志组件试图写库却连不上）
- 开启框架查询日志（如 Laravel 的
DB::enableQueryLog()）前，先确认连接已建立——否则日志本身就会触发连接尝试，形成死循环
真正卡住的时候，别急着翻框架文档，先看 PHP 错误日志里最上面那条原始报错，再对照 phpinfo() 里的 PDO 支持状态和 MySQL 服务的实际监听地址。很多所谓“框架连接失败”，其实是 mysqld 根本没起来，或者 bind-address 写死了 127.0.0.1 却从容器外访问。
