绝大多数thinkphp数据库连接失败的根本原因是php未启用pdo扩展或未安装对应驱动，而非框架配置错误；需先检查php -m输出、dockerfile扩展安装、php.ini配置及环境变量加载顺序。
报错提示含 PDOException 或 Driver not found 怎么快速定位
绝大多数 ThinkPHP 数据库连接失败，根本原因不在框架配置，而在 PHP 本身的 PDO 扩展是否启用、对应驱动是否装好。看到 PDOException 不要急着改 database.php，先确认底层有没有“轮子”。
实操建议：
- 运行
php -m | grep pdo，确认输出含pdo和对应驱动（如pdo_mysql、pdo_pgsql） - 若用 Docker，检查
Dockerfile是否执行了docker-php-ext-install pdo pdo_mysql（MySQL 场景） - Windows 下常见问题：php.ini 中
extension=php_pdo_mysql.dll被注释，或路径不对导致 DLL 加载失败 - ThinkPHP 6+ 默认用
pdo_mysql驱动，但若你配了'type' => 'mysql'却没装扩展，它不会降级，直接抛Driver not found
database.php 里 hostname 和 port 填错的典型表现
填错不一定会报“连接拒绝”，有时是超时、有时是空响应，尤其在容器或云数据库场景下容易误判为网络问题。
实操建议：
-
hostname别写localhost—— 容器内它指向本容器，不是宿主机；该写host.docker.internal（Docker Desktop）或具体服务名（如mysql） -
port默认是3306，但阿里云 RDS、腾讯云 CDB 常用非标端口，务必核对控制台显示的“连接地址”和“端口”，别凭记忆填 - 如果用 socket 连接（如
unix_socket），hostname必须为空，且unix_socket路径要绝对、可读，否则报SQLSTATE[HY000] [2002] - 测试连通性别只信
ping，用mysql -h <code>hostname-Pport-uusername-p 实际试一次
ThinkPHP 6 的 think-swoole 下 PDO 连接复用失效怎么办
Swoole 常驻内存模型会让 PDO 实例跨请求存活，而 MySQL 默认断开闲置连接（wait_timeout 通常 8 小时），下次请求拿旧连接就报 MySQL server has gone away。
实操建议：
- 在
database.php中开启'break_reconnect' => true，让框架自动重连（仅 TP6.1+ 支持） - 避免手动
new \PDO(...)，一律走Db::或注入ConnectionInterface，否则无法享受连接池与重连逻辑 - 若用
pdo_sqlsrv（SQL Server），必须设'options' => [PDO::ATTR_PERSISTENT => false]，Swoole 下持久连接会出错 - 不要在
onWorkerStart里预创建 PDO 实例，TP 自带连接池已处理初始化，手动做反而绕过重连机制
环境变量 DB_HOST 覆盖失败？检查 .env 加载顺序
ThinkPHP 6 默认从 .env 加载配置，但如果你在 database.php 里写了死值（比如 'hostname' => '127.0.0.1'），环境变量就完全不起作用——框架不会“合并”或“覆盖”，而是直接用 PHP 文件里的值。
实操建议：
- 确保
database.php中所有数据库字段都用Env::get('DB_HOST', '127.0.0.1')这类方式取值，而不是硬编码 -
.env文件必须放在项目根目录（与think可执行文件同级），且不能有 BOM 头，否则Env类解析失败，变量全为空 - 运行
php think env:show可直观看到哪些变量被成功加载，比猜强得多 - CI/CD 环境常把
.env当敏感文件排除，结果部署后还是用的本地默认值——检查构建产物里有没有.env
最麻烦的永远不是“怎么配”，而是“以为配对了”。PDO 报错信息常模糊，Driver not found 可能是扩展没装，也可能是扩展名拼错（pdo-mysql vs pdo_mysql）；Connection refused 可能是端口错，也可能是防火墙拦了容器网段。动手前，先确认错误到底来自哪一层。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
