ThinkPHP 8.0 小版本升级通常无需修改 database.php，但需重点验证 deploy、charset、failover 等配置项兼容性及连接、事务、日志行为，避免因隐式变更引发故障。
ThinkPHP 8.0 的小版本升级（如从 8.0.0 升到 8.0.2）**通常不需要调整数据库配置**，但必须验证现有配置是否仍被新版本完全支持——尤其当升级涉及连接池、驱动行为或安全策略变更时。
哪些小版本更新可能悄悄影响 database.php
TP8 的 patch/minor 版本虽承诺向后兼容，但实际修复中会收紧底层行为。以下情况需检查配置：
-
'deploy' => 1在8.0.1后才真正启用读写分离自动识别，若旧版未开此开关，升级后不补上会导致主从路由失效 -
'charset'默认值在8.0.3中从'utf8'改为'utf8mb4'，若显式写死为'utf8'且 MySQL 8.0+ 服务端禁用该别名，连接会失败 -
'failover'选项在8.0.2新增支持数组形式故障转移节点，但若旧配置里用了字符串格式（如'failover' => '192.168.1.10'），新版会静默忽略而非报错 - MySQL 8.0 认证插件兼容逻辑在
8.0.4加强：对caching_sha2_password的 fallback 更鲁棒，但前提是'hostname'仍为'127.0.0.1'—— 若你之前靠改插件绕过问题，升级后可尝试切回原插件，但配置本身不能动
升级后必须验证的三处数据库配置行为
光看配置文件没用，得跑真实连接和查询：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 执行
php think db:connect（需安装topthink/think-orm-migrate）确认能连通，而不是仅靠Db::query('SELECT 1')这种轻量探测 - 在事务中故意触发异常（如插入重复主键），检查
rollback()是否真回滚——8.0.1修复了 PDO 事务嵌套时rollback()失效的问题，但若配置里'deploy' => 0，该修复不生效 - 查日志
runtime/log/下是否有Deprecated: The "fetch_mode" option is deprecated类警告，这是8.0.2开始标记的旧参数，虽不报错但说明配置已过时
为什么改配置反而容易出事
小版本升级的核心原则是“最小改动”，而数据库配置恰恰是风险高发区：
立即学习“PHP免费学习笔记（深入）”；
- 手动添加
'options' => ['ssl' => [...]]可能触发8.0.3中新增的 SSL 验证强制流程，若证书路径错误，连接直接超时而非友好提示 - 把
'type' => 'mysql'改成'type' => '\think\db\connector\Mysql'这类全限定类名写法，在8.0.0可用，但8.0.2已移除该反射入口，运行时报Class not found - 为适配旧版写的
'params' => [PDO::ATTR_CASE => PDO::CASE_LOWER]，在8.0.1后被 ORM 层拦截并覆盖，导致字段名大小写行为与预期不符
真正要动配置的信号只有一个：升级后 php think clear + php think optimize:schema 执行完，访问任何带数据库操作的接口都抛出 PDOException 或空响应，且日志里明确出现驱动层关键词（如 Connection refused、Unknown auth plugin）。其他时候，别碰 database.php —— 它比你想的更脆弱。
