ThinkPHP数据库驱动缺失_ThinkPHPDriver文件修复技巧【汇总】-ThinkPHP-PHP中文网

根本原因是php未安装或未启用对应pdo驱动，需先检查php -m或phpinfo()确认pdo及pdo_mysql等驱动存在，再确保thinkphp的type配置为'mysql'等严格匹配的驱动名，最后核对cli与web环境php.ini一致并重启服务。

thinkphp数据库驱动缺失_thinkphpdriver文件修复技巧【汇总】

ThinkPHP 报 “Driver not found” 或 “could not find driver”，90% 不是配置写错了，而是 PHP 底层没装或没启 PDO 驱动。 别急着改 database.php，先确认 pdo_mysql（或其他你用的驱动）在 PHP 里真实可用。

检查 PHP 是否真加载了 PDO 驱动

报错说“找不到驱动”，第一反应不该是翻框架代码，而是查 PHP 自身。CLI 和 Web 环境可能用不同 php.ini，导致一个环境通、另一个报错。

运行 php -m | grep pdo，必须看到 pdo 和 pdo_mysql（或 pdo_pgsql 等）；缺哪个就装哪个
Web 环境下访问 phpinfo() 页面，搜索 PDO drivers，确认列表里有你要的驱动名（注意：不是 mysqli，那是另一个扩展）
Linux 下常见漏装：sudo apt install php-pdo php-mysql（Ubuntu/Debian），或 yum install php-pdo php-mysqlnd（CentOS/RHEL）
Windows 用户检查 php.ini 中 extension=php_pdo.dll 和 extension=php_pdo_mysql.dll 前的分号是否已去掉
CLI 下执行 php --ini 查配置路径，Web 下看 phpinfo() 的 Loaded Configuration File，两个文件都要检查并重启服务

ThinkPHP 配置中的 type 必须严格匹配 PDO 驱动名

type 字段不是随便写“mysql”“pdo_mysql”“MySQL”都行——它必须和 PDO 扩展注册的驱动名完全一致，大小写、下划线都不能错。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

合法值只有：mysql、pgsql、sqlite、sqlsrv、oci；不能写成 pdo_mysql，也不能写成 MySQL
TP6+ 的 config/database.php 中，connections.default.type 必须是字符串，比如 'type' => 'mysql'，不是数组
若用 PostgreSQL，配置写 'type' => 'pgsql'，少字母、多空格、加引号外的字符都会失败
MySQL 8.0+ 用户额外注意：charset 建议设为 utf8mb4，否则 emoji 插入会静默截断

TP6/TP8 升级后类路径变更引发的 Driver not found

TP6 起 MySQL 连接器类从 think\db\connector\Mysql 移到了 think\db\connector\PdoMysql，旧代码硬编码路径就会直接报 Class 'think\db\connector\Mysql' not found。

全局搜索项目中所有 use think\db\connector\Mysql，替换成 use think\db\connector\PdoMysql
检查自定义数据库封装类，若重写了 connect() 方法，实例化时要用 new PdoMysql()，不是 new Mysql()
第三方包如 topthink/think-orm 必须升到 v3.0+，低版本不兼容新路径
TP8 视图报 Driver [Think] not supported？那不是数据库问题，是缺 topthink/think-view 包，执行 composer require topthink/think-view 即可

MySQL 8.0+ 认证插件不兼容导致连接被拒

MySQL 8.0 默认用 caching_sha2_password 插件，而旧版 PHP 的 pdo_mysql 扩展不支持，错误信息类似：Authentication plugin 'caching_sha2_password' cannot be loaded。

临时方案：进 MySQL 执行 ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass';
长期方案：升级 PHP 到 7.4+，并确认 pdo_mysql 编译时启用了 --with-mysqlnd（运行 php -i | grep "mysqlnd" 验证）
远程连接失败？别只测本地 mysql -h127.0.0.1，还要确认 MySQL 的 bind-address 允许外部访问，且服务器防火墙放行对应端口

最常被忽略的一点：TP6/TP8 的驱动加载发生在 Connection 构造阶段，而 Composer 自动加载是否生效，取决于 vendor/autoload.php 是否被正确引入。如果项目从低版本升级，或手动修改过引导逻辑，think-orm 的驱动检测可能跳过，导致错误信息模糊。建议每次部署后，在入口文件里加一行 var_dump(class_exists('think\db\connector\PdoMysql')); 快速验证类是否能被加载。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！