thinkphp 5.1+ 无法使用 mysql 驱动,因其已被彻底废弃,必须改用 pdo_mysql 并正确配置 dsn(含 charset),同时注意连接池缓存、预处理日志误导及 pdo 兼容性问题。

ThinkPHP 5.1+ 里 mysql 驱动为什么连不上?
因为 mysql 扩展在 PHP 7.0+ 已被移除,ThinkPHP 5.1 起也彻底废弃了 mysql 驱动类。你看到的 Class 'mysql' not found 或 Driver [mysql] not supported 错误,根本不是配置写错,而是驱动本身已不存在。
必须切换到 pdo_mysql,且确保 PHP 已启用 pdo 和 pdo_mysql 模块(php -m | grep pdo 可验证)。
-
database.php中把'type' => 'mysql'改成'type' => 'pdo' - 同时补全
'dsn' => 'mysql:host=127.0.0.1;dbname=xxx;charset=utf8mb4',不能只靠hostname/database等零散参数 - 若沿用旧版自动拼接 DSN 的习惯,会因缺少
charset导致中文乱码或连接失败
自定义 PDO 驱动时 think\db\connector\Pdo 怎么继承?
官方 Pdo 基类不直接支持多数据库类型混用(比如想让一个驱动同时处理 MySQL 和 PostgreSQL),但你可以继承它并重写 parseDsn() 和 getFields() 等关键方法。
注意:不要复制整个 Pdo.php 再改——ThinkPHP 6+ 的 think\db\connector\Pdo 是抽象基类,必须实现 initConnect();而 TP5.1 的对应类是 think\db\connector\Mysql(已废弃)或 think\db\connector\Pdo(需手动指定 dsn)。
- 继承
think\db\connector\Pdo后,在__construct()里调用parent::__construct($config),别漏掉 -
parseDsn()返回的 DSN 字符串必须含charset,否则execute()执行 SQL 时可能报SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client - 若扩展中用了
$this->linkID->getAttribute(PDO::ATTR_SERVER_VERSION),要加try/catch,部分云数据库(如阿里云 RDS)返回空版本号会导致致命错误
Db::connect() 切换配置后查询仍走旧连接?
这是连接池缓存导致的——ThinkPHP 默认对相同 DSN 复用连接。即使你传入新配置数组,只要 dsn 字符串完全一致(包括空格、分号位置),就会命中已有连接。
典型场景:同一套代码连测试库和正式库,仅靠动态改 database 名,但没更新 dsn,结果查的还是旧库。
- 强制刷新连接:在
Db::connect($config)后立刻调用Db::close(),再执行查询 - 更稳妥的做法是给每个连接配唯一标识,比如在
dsn末尾加;uid=test_v2(PDO 忽略未知参数,但能破坏缓存键) - TP6.0+ 支持
'deploy' => 1主从分离,但若主库配置里dsn相同,从库也会复用主库连接,造成事务异常
迁移后 getLastSql() 显示的 SQL 和实际执行不一致?
这是因为 PDO 预处理机制下,ThinkPHP 日志里的 getLastSql() 是绑定参数前的模板 SQL(含 ? 占位符),而真实执行的是 PDO 替换后的语句。调试时若只看这个,会误判参数是否生效。
尤其在使用 whereRaw() 或闭包查询时,占位符顺序和实际绑定值可能错位,导致 SQL 逻辑偏差。
- 查真实执行语句,得开 PDO 的
PDO::ATTR_EMULATE_PREPARES => false并配合 MySQL 的general_log(SET GLOBAL general_log = 'ON') - TP5.1 中
think\db\Query的buildSql()方法可生成完整 SQL(含参数值),但它不走预处理,仅用于调试,不能直接执行 - 如果用了
bind()绑定变量名(如:name),getLastSql()不会展开,必须用getRealSql()(TP6.0+)或自行拼接
驱动迁移不是改个配置就完事。最常被忽略的是 DSN 中 charset 缺失、连接复用逻辑干扰、以及预处理下 SQL 日志的误导性——这三个点卡住的人最多。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










