ThinkPHP 8 无内置数据库连接测试命令，需用 php -r、Db::connect() 或最小化 PHP 脚本验证；优先推荐 php -r 方式快速暴露网络、凭证及服务问题，其次用 Db::connect() 模拟框架真实连接路径，最后用独立脚本排除自动加载干扰。
ThinkPHP 8 本身不提供开箱即用的数据库连接测试命令，php think test 是单元测试入口，不能用来验证数据库连通性；真要测连接是否成功，得绕过框架封装，直接走底层驱动或用 PHP 原生方式验证。
用 php -r 快速验证 MySQL 连通性
这是最轻量、最可靠的手段，不依赖 ThinkPHP 加载逻辑，能第一时间暴露网络、凭证、服务状态问题。
- 终端执行：
php -r "$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4'; try { $pdo = new PDO($dsn, 'root', 'your_password', [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]); echo "✅ PDO 连接成功\n"; } catch (Exception $e) { echo "❌ " . $e->getMessage() . "\n"; }" - 若提示
Connection refused：MySQL 未启动，或端口被防火墙拦截（注意 TP8 默认读DB_PORT，但这里要和实际服务端口一致） - 若提示
Access denied：用户名/密码错误，或用户没权限访问指定库（TP8 的DB_USER/DB_PASS必须能连上DB_NAME） - 别用
mysqli_connect()测试后就认为 OK——TP8 默认用 PDO，驱动行为不完全等价
在 TP8 中用 Db::connect() 手动触发连接
这一步不是“测试”，而是模拟框架真实使用的连接路径，能发现配置加载、环境变量解析、连接池初始化等环节的问题。
- 进
php think tinker，执行：Db::connect('mysql')->query('SELECT 1'); - 如果报
SQLSTATE[HY000] [1045] Access denied for user...，说明.env或config/database.php里的DB_USER/DB_PASS没生效（常见于.env文件权限不对、未重命名.env.example） - 如果报
SQLSTATE[HY000] [2002] Connection refused，说明 TP8 解析出的hostname或hostport和实际不符（比如DB_HOST写成了localhost，但容器内 DNS 不解析） -
Db::connect('mysql')返回的是连接实例，不是单例——每次调都会新建连接，别在循环里这么用
写个最小化测试脚本，避开自动加载干扰
当 tinker 启动失败、或 Composer 自动加载异常时，这个脚本能绕过框架，直击 PDO 初始化逻辑。
立即学习“PHP免费学习笔记（深入）”；
- 新建
test_db_raw.php放项目根目录，内容如下：
<?php
require_once 'vendor/autoload.php';
$env = parse_ini_file('.env', true);
$dsn = sprintf(
'mysql:host=%s;port=%s;dbname=%s;charset=utf8mb4',
$env['DB_HOST'] ?? '127.0.0.1',
$env['DB_PORT'] ?? '3306',
$env['DB_NAME'] ?? 'test'
);
try {
$pdo = new PDO($dsn, $env['DB_USER'] ?? 'root', $env['DB_PASS'] ?? '', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
echo "✅ 数据库连接成功，当前库：" . ($env['DB_NAME'] ?? 'test') . "
";
} catch (PDOException $e) {
echo "❌ " . $e->getMessage() . "
";
}
- 运行：
php test_db_raw.php - 这个脚本不 require TP 核心，只依赖
.env和 PDO，结果可信度最高 - 如果它成功但 TP8 失败，问题一定出在
config/database.php的connections配置结构或环境变量覆盖逻辑上
真正难排查的不是“连不上”，而是“看似连上了但查不出数据”——比如 DB_PREFIX 配置错导致表名拼错，或者 charset 不匹配引发中文乱码查询为空。这些不会报连接错误，但会让业务逻辑静默失败。
