ThinkPHP6是完全重写的框架，不兼容TP5，必须新建项目迁移；配置改用.env和模块化config/；路由需显式启用merge_param；Db/模型返回Collection须转数组；缺失功能需安装对应扩展。
ThinkPHP5升级到6经常报错，是因为TP6不是TP5的升级版而是全新重写的框架，直接覆盖或composer update必然触发Class not found、param()失效、配置静默不生效等连锁错误，必须按重构逻辑逐项校验迁移是否到位。
确认是否真在用TP6而非“假升级”
打开项目根目录，执行php think version；若输出ThinkPHP v5.1.42或类似v5.x版本号，说明根本没切换成功——【TP6必须新建项目，不能原地覆盖】。
检查composer.json中"topthink/framework"的版本号是否为^6.0；若仍是^5.1，运行composer remove topthink/framework && composer require topthink/framework:^6.0会失败，因为依赖冲突不可逆。
删掉vendor/和composer.lock，执行composer create-project topthink/think tp6拉取干净骨架，再把旧逻辑迁入。
立即学习“PHP免费学习笔记（深入）”；
命名空间与路径不匹配导致Class not found
方法一：检查控制器文件路径与命名空间是否严格一致
例如app/controller/User.php的命名空间必须是namespace app\controller;，不能写成App\Controller或app/controller/（末尾斜杠）。
Linux服务器下User.php和user.php是两个文件，Windows开发时无感，部署后立刻报错——【所有类名首字母必须大写，文件名大小写必须与命名空间完全一致】。
方法二：强制刷新自动加载映射
运行composer dump-autoload -o，别只清缓存或改完就跑；若仍报错，用composer show -p确认app\是否已注册为PSR-4前缀。
路由参数取不到、input()失效
第一步：确认路由定义是否开启merge_param
TP6默认不合并URL路径参数，旧写法Route::get('user/:id', 'user/read')迁移后$request->param('id')始终为空。必须显式加选项：Route::get('user/:id', [\app\controller\User::class, 'read'])->option(['merge_param' => true])。
第二步：统一替换参数获取方式
旧代码中所有input('id')全部改为$request->param('id')，并确保该$request对象来自控制器方法参数注入，而非Request::param()静态调用（TP6已废弃）。
第三步：验证PATH_INFO是否正确传递
在public/index.php顶部加var_dump($_SERVER['PATH_INFO']);die;，访问/user/123，输出应为/user/123；若为空，说明Nginx未正确转发，需检查fastcgi_split_path_info和PATH_INFO参数配置。
数据库查询返回Collection却当数组用
Db::name('user')->select()和模型UserModel::select()在TP6中全部返回think\Collection对象，不再是PHP数组。
直接foreach($list as $item)会报错，必须先调用->toArray()：foreach($list->toArray() as $item)。
模型查询结果不能直接return $user，要显式包装：return json(['data' => $user->toArray()]);或使用success($user)助手函数。
Session不生效、模板找不到
Session默认不自动启动，调用session('user_id', 123)会静默失败。必须在中间件或控制器initialize()中显式执行session()->start();。
模板引擎需手动安装：composer require topthink/think-view，否则$this->fetch('index')直接报错；安装后确认config/app.php中'view_replace_str'等配置项存在且格式正确。
模板路径拼接规则已变：$this->fetch('index')实际查找view/index.html，不是view/index/index.html；若控制器在app\controller\admin\User.php，想渲染view/admin/user/index.html，必须写$this->fetch('admin/user/index')。
