PDO扩展未启用或配置不匹配是主因：需分别检查CLI与Web环境的php.ini中pdo/pdo_mysql扩展是否启用，确认数据库配置项准确、密码URL编码、MySQL用户权限及认证插件兼容性，并开启TP调试日志定位真实错误。
检查 pdo_mysql 扩展是否真正启用
ThinkPHP 启动时提示“could not find driver”或“Class 'PDO' not found”，大概率不是没装扩展，而是没在当前 PHP 环境中启用。CLI 和 Web（如 Apache/Nginx）可能使用不同 php.ini，导致命令行能连、网页打不开。
- 运行
php -m | grep pdo确认 CLI 下已加载pdo和pdo_mysql - 在 Web 环境中新建
phpinfo.php，访问并搜索 “Loaded Configuration File”，找到实际生效的php.ini路径 - 打开该
php.ini，确认extension=php_pdo.dll（Windows）或extension=pdo.so（Linux/macOS）和extension=php_pdo_mysql.dll/extension=pdo_mysql.so未被注释且路径正确 - 重启 Web 服务（
sudo systemctl restart apache2或sudo nginx -s reload），再刷新phpinfo()
验证数据库配置是否匹配真实环境
ThinkPHP 的 database.php 配置项写错一个字母（比如把 host 写成 hostname）或端口填成字符串，都会静默失败——它不会报“配置错误”，而是直接抛 PDO 连接异常。
-
host值别写localhost：MySQL 默认对localhost使用 Unix socket，而127.0.0.1才走 TCP；若 MySQL 绑定的是127.0.0.1，用localhost就连不上 -
port必须是整数，不能写成'3306'（字符串）——ThinkPHP 5.1+ 会传给 PDO 构造函数，类型不对会触发警告后降级为默认端口 - 密码含特殊字符（如
@、/、:）必须 URL 编码，否则 DSN 解析失败；例如密码是p@ss/wd，应写为p%40ss%2Fwd - 检查
database（库名）是否存在、用户是否有权限：mysql -u your_user -p -h 127.0.0.1 -P 3306手动登录试试
区分 ThinkPHP 版本对 PDO DSN 的处理差异
TP6 默认用长连接 + 字符集强制声明，TP5.1 则依赖配置项拼接；如果手动改过 dsn 配置，容易因版本升级导致 DSN 格式冲突，出现“SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client”这类错误。
- TP6 中
dsn配置优先级最高，一旦设置，其他 host/port/database 等字段会被忽略；不建议直接写死 DSN，除非你明确控制全部参数 - TP5.1 的 DSN 是自动拼的，但如果你在
database.php里写了'dsn' => 'mysql:host=...'，它会跳过拼接逻辑，此时必须确保 DSN 完整且包含;charset=utf8mb4 - MySQL 8.0+ 默认认证插件是
caching_sha2_password，老版本 PHP/PDO 不支持；临时解决是建用户时指定：CREATE USER 'tp'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';
开启 ThinkPHP 数据库调试日志定位真实错误
页面只显示“数据库连接失败”，但具体是 DNS 解析失败、连接超时、认证拒绝，还是权限不足？光看异常信息不够，得让 TP 把底层 PDO 异常吐出来。
立即学习“PHP免费学习笔记（深入）”；
- 在
config/database.php中确保'debug' => true，并在'deploy' => 0（开发模式）下运行 - 查看运行时日志：
runtime/log/年-月/日.log，搜索PDOException，里面会有类似SQLSTATE[HY000] [2002] No such file or directory这种原始错误 - 如果日志里只有“connection refused”，重点查 MySQL 是否在运行：
systemctl status mysql或ps aux | grep mysqld - 若用 Docker，确认容器间网络互通：
docker exec -it your_php_container ping mysql_container_name
最常被忽略的是：Web 服务器用的 PHP 和你在终端敲 php -v 看到的不是同一个二进制，扩展状态、ini 文件、甚至 PHP 版本都可能不同。先搞清“哪个 PHP”在跑 TP，再查“哪个 ini”在生效，比反复重装扩展有用得多。
