ThinkPHP 8.0.5 升级无需修改 config/*.php 文件结构，因小版本严格遵循语义化规范，仅修复 Bug 与增强安全；报错主因是 composer.lock 未更新、runtime/config 缓存未清或第三方扩展未适配，而非配置项变更。
ThinkPHP 8.0 升级到 8.0.5 不会引发配置文件结构不兼容——它属于小版本补丁升级，config/ 目录下所有 PHP 配置文件（如 app.php、database.php、session.php）的键名、嵌套层级、默认值含义均保持完全一致。
为什么 config/*.php 文件能直接沿用
TP8.0.x 系列（8.0.0 → 8.0.5）严格遵循语义化版本规范：小版本仅修复 Bug、增强安全、微调行为，不修改公共配置契约。官方从未在 8.0.x 中删除或重命名任何配置项，也未改变其数据类型约束（比如 'default_return_type' 仍只接受 'json'，'prefix' 仍为字符串）。
常见误判来源是升级后突然报错，但真正原因往往不是配置本身，而是：
- composer.lock 未更新导致旧依赖残留（例如
topthink/think-orm仍卡在 3.0.12，而 8.0.5 要求 ≥3.0.14） - 运行时缓存未清除：
runtime/config/下的编译后配置文件被复用，而新版本对某些配置做了运行时校验（如session.store缺少'timeout'时，8.0.4 不报，8.0.5 会抛异常） - 第三方扩展（如
topthink/think-swoole或自定义 provider）未同步适配，间接影响配置加载顺序
升级前必须检查的三项配置相关动作
即使配置文件语法无变化，以下操作漏掉任一环节都可能让 8.0.5 启动失败或行为异常：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 执行
composer update topthink/framework topthink/think-orm topthink/think-filesystem --with-all-dependencies，避免子依赖版本错位 - 手动删掉
runtime/config/全部内容（不要只删.php，保留目录结构），强制框架重新解析并编译配置 - 确认
config/session.php中'store'数组已显式声明全部必需字段（'host'、'port'、'database'、'timeout'），8.0.5 对 Redis store 的参数完整性校验比 8.0.0 更严格
哪些配置改动在 8.0.5 中实际发生了
真正有变更的是「运行时行为」，而非配置文件结构。例如：
-
config/log.php中'level'默认值仍为'debug'，但 8.0.5 新增了对log.trace日志通道的自动初始化逻辑，若你自定义了trace驱动但未在配置中声明，会触发InvalidArgumentException -
config/database.php的'deploy'字段仍有效，但 8.0.5 对读写分离连接池的超时判定更激进——若'read_timeout'设为0（表示不限制），现在会直接拒绝启动 -
config/app.php的'middleware'数组格式不变，但 8.0.5 开始校验中间件类是否真实实现了think\contract\MiddlewareInterface，若某中间件只写了handle()方法却没implements接口，会在首次路由匹配时报TypeError
最易被忽略的是：8.0.5 强制要求所有配置 provider 类（如 app/provider/DatabaseProvider.php）的 register() 方法必须返回 void，若老代码里写了 return $this;，就会因返回类型不匹配而 fatal error——这不属于配置文件范畴，但常和配置升级混在一起排查。
