ThinkPHP数据库版本太低_ThinkPHP兼容性升级指南【汇总】

搞ThinkPHP开发的老铁们，基本上都遇到过“数据库连接失败”的鬼问题。要我说啊，这里面90%的锅，都不是框架本身的bug，而是MySQL版本、认证插件或者PHP扩展跟TP没对上眼。光升级框架没用，根本治不了底层的连接失败。

MySQL 8.0+ 认证插件不兼容：The server requested authentication method

这是TP5.1或6.0连MySQL 8.0+时最典型的报错，错误信息里会带着SQLSTATE[HY000] [2054]和The server requested authentication method。怎么回事呢？根本原因在于，MySQL 8.0默认用了caching_sha2_password这个认证插件，而旧版PHP（尤其是PHP 7.x）的mysqlnd扩展压根不认识它。

• 临时救急：登录MySQL，执行这条命令：ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;
• 长远之计：直接把PHP升级到8.0及以上版本，新版自带了支持新插件的mysqlnd。完事别忘了用php -m | grep mysqlnd确认扩展加载正常。
• 千万别折腾：别去碰old_passwords=1这种老古董配置，MySQL 8.0已经把这玩意儿移除了。

PHP MySQL 扩展缺失或混用：Call to undefined function mysql_connect()

如果你还在用TP 5.0甚至更老的版本，项目里可能残留了原生mysql_*函数的调用。在PHP 8.0+环境下，这哥俩一碰面，就会直接给你来个Fatal error: Uncaught Error: Call to undefined function mysql_connect()。注意了，这可不是ThinkPHP自身的毛病，是你项目里历史遗留的老代码或者某些第三方插件埋的雷。

• 全面搜捕：在整个项目目录里（包括vendor/），全局搜索所有以mysql_开头的函数，比如mysql_query、mysql_fetch_array这些。
• 对照检查：看看这些函数是不是真的在用。绝大多数TP项目走的是\think\Db::table()或者PDO，这些调用很大概率只是没人清理的垃圾代码。
• 替换原则：一律改成\think\Db::query()或者模型操作。别图省事手动new一个PDO，那样会绕过框架自带的连接池和日志功能。
• 配置文件审查：看看php.ini里有没有错误地启用了extension=php_mysql.dll（Windows）或extension=mysql.so（Linux），有的话直接删掉或注释掉。

数据库驱动配置大小写敏感：Driver [MySQL] not supported

在TP6和TP8里，database.php这个配置文件有个坑：你要是写'type' => 'MySQL'，它就会给你报个错Driver [MySQL] not supported。因为框架内部注册的驱动名都是小写字符串，你写成大写，它就找不着对应的类了。

• 必须小写：把'type' => 'MySQL'改成'type' => 'mysql'。
• 一视同仁：同理，所有驱动名，像'sqlsrv'、'pgsql'、'sqlite'，都得全部小写，首字母大写一点用都没有。
• 自定义驱动：如果你用了自定义驱动，确保它的类名和注册名完全匹配，并且PSR-4自动加载的路径是对的。

ORM 查询返回类型变更导致空指针：Trying to access array offset on value of type null

这是个挺隐蔽的坑。TP8的think-orm ^3.0默认查询返回的是Collection或者模型实例，不再像以前那样自动转成数组。如果你的代码里还在写$data[0]['name']，而$data实际上是个对象，在PHP 8.2+版本下，就会触发Warning: Trying to access array offset on value of type null。

• 显式转换：查询单条数据用->find()->toArray()，查询列表用->select()->toArray()。
• 模型设置：在模型类里加上protected $autoWriteTimestamp = false;，可以避免一些隐式触发的问题。
• 别凭经验：别以为Db::table()->where()->select()返回的还是数组，它返回的其实是Collection，不是array。
• 模板里多留个心眼：在模板里用{$list.0.name}之前，最好先用{if $list}判断一下，否则PHP 8.2会给你弹出警告。

最后说一个最容易被忽略的地方：MySQL用户权限和认证插件的组合状态。这玩意儿不报错，只会安安静静地拒绝连接。还有就是ORM返回值类型这个变化，从“习惯性数组”变成“严格对象”，它不会立刻让系统崩溃，但会在某次PHP升级后突然暴露出来，让你措手不及。