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

thinkphp数据库错误90%源于mysql版本、认证插件或php扩展不匹配：mysql 8.0+默认caching_sha2_password需改用mysql_native_password或升级php 8.0+；禁用废弃mysql_*函数及扩展；database.php中type必须小写如'mysql'；tp8 orm返回collection需显式toarray()避免空指针。

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

ThinkPHP 报数据库相关错误，90% 不是框架问题，而是 MySQL 版本、认证插件或 PHP 扩展不匹配导致的。直接升级框架解决不了底层连接失败。

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 的 mysqlnd 扩展（尤其 PHP 7.x）不支持。

临时修复：登录 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 自身代码的问题，而是你项目里的历史代码或第三方插件写的。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

全局搜索整个项目（含 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/8 中 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。