应先用db::table()->select()验证连接有效性，再通过原生pdo直连定位是框架配置还是环境问题；检查database.php中default与connections键名是否严格匹配，并确认.env未错误覆盖配置。
Db::connect() 调用失败、select() 报 SQLSTATE[HY000] [2002] Connection refused 或 SQLSTATE[HY000] [1045] Access denied，基本就是连接参数错、服务未启、或配置没生效——别急着改代码，先用最轻量的方式验证。
用 Db::connect() + select() 快速验证连接有效性
这是 ThinkPHP6 最贴近真实请求路径的测试方式，能同时验证配置加载、PDO 初始化、网络连通性和权限。它比纯 PHP 原生连接多走了一层框架抽象，但恰恰因此能暴露框架级问题（比如 default 配置未生效、connections 键名拼错）。
在任意可执行上下文（如控制器、命令行指令、php think run 临时脚本）中写：
use think\Facade\Db;
<p>// 测试默认连接
$result = Db::table('user')->limit(1)->select();
dump($result);</p><p>// 测试指定连接（比如 config/database.php 中定义的 'admin'）
$result = Db::connect('admin')->table('administrator_information')->limit(1)->select();
dump($result);
</p>
- 若返回空数组但无报错 → 表存在但无数据，连接成功
- 若抛出
Connection refused→ MySQL 服务未运行、端口被拦、或hostname写成localhost但 MySQL 绑定的是127.0.0.1（反之亦然） - 若抛出
Access denied→username/password错，或用户没授权访问该库 - 若报
Base table or view not found→ 连接成功，但表名/库名不匹配，检查database和实际库名是否一致
绕过框架直连 PDO，定位是 TP6 配置问题还是环境问题
当 Db::connect() 失败，但你怀疑是框架配置加载异常（比如 .env 覆盖了 database.php 却没生效），就该跳过 TP6，用原生 PDO 直连验证底层是否通畅。
新建一个 test_pdo.php 放在项目根目录，内容如下：
<?php $host = '127.0.0.1';
$dbname = 'user';
$user = 'root';
$pass = 'root';
$dsn = "mysql:host={$host};dbname={$dbname};charset=utf8mb4";
<p>try {
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]);
echo "✅ PDO 连接成功\n";
$stmt = $pdo->query("SELECT 1 as ok");
var_dump($stmt->fetch());
} catch (PDOException $e) {
echo "❌ PDO 连接失败: " . $e->getMessage() . "\n";
}
- 成功 → 说明环境没问题，问题出在 TP6 的
database.php配置或.env解析逻辑上 - 失败且提示
Connection refused→ 检查 MySQL 是否运行：systemctl status mysql（Linux）或任务管理器（Windows） - 失败且提示
Unknown database→dbname值和实际创建的库名不一致 - 注意：TP6 默认用
utf8，但 PDO 推荐utf8mb4；如果测试时用utf8报错，换utf8mb4再试
检查 database.php 中 default 和 connections 键名是否匹配
TP6 不会自动把 connections 下的任意键当作可用连接，必须确保你在 Db::connect('xxx') 里传的字符串，和 connections 数组的 key 完全一致——包括大小写、下划线、空格。
常见错误示例：
'connections' => [
'user_db' => [ /* ... */ ], // 实际定义的是 'user_db'
],
'default' => 'user', // 但 default 写成了 'user'，导致 Db::table() 默认连错
- 运行
php -r "var_dump(config('database'));"查看最终合并后的配置结构，确认default值是否存在于connections中 - 若使用
.env，确认其内容格式正确：DATABASE_HOSTNAME=127.0.0.1，且键名与database.php中Env::get('database.hostname')引用的路径一致 -
connections里定义了'admin'，但代码里写了Db::connect('Admin')→ 大小写敏感，必报错 - 删掉
.env文件再试一次，可快速判断是不是环境变量覆盖出了问题
CLI 模式下长期运行脚本报 2006 错误？检查 break_reconnect
如果你在定时任务或长时 CLI 脚本中遇到 SQLSTATE[HY000]: General error: 2006 MySQL server has gone away，不是连接测不通，而是连接空闲超时被 MySQL 主动断开。
ThinkPHP6 提供了自动重连开关，但默认是关闭的：
'break_reconnect' => false, // ← 默认值，不重连
- 改为
true后，框架会在 PDO 抛出致命连接异常时，尝试重新初始化连接并重试当前查询 - 仅对 PDO 异常有效，对语法错误、权限拒绝等业务层错误无效
- 开启后会有轻微性能损耗（每次查询前多一次连接状态判断），但对 CLI 场景利远大于弊
- 注意：重连不保证事务一致性，勿在事务块中依赖此机制
真正卡住人的往往不是“怎么连”，而是“连的时候谁在中间动了手脚”——.env 覆盖、default 键名错位、PDO DSN 字符集不兼容、CLI 空闲超时，这些点漏查一个，调试就会绕弯。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
