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）。
立即学习“PHP免费学习笔记（深入）”；
- 继承
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 日志的误导性——这三个点卡住的人最多。
