Parse error: syntax error, unexpected token "string"表明仍在用ThinkPHP 5.1运行于PHP 8.0+，因TP5.1底层不兼容PHP 8新语法，必须升级至TP8.0并完成重写级迁移，不可仅改版本号或依赖。
Parse error: syntax error, unexpected token "string" 这类报错一出现，基本可以确定你还在用 ThinkPHP 5.1 强行跑在 PHP 8.0+ 上——这不是配置问题，是框架底层根本不兼容。必须升到 ThinkPHP 8.0，但直接 composer update 会炸。
TP5.1 到 TP8.0 不是升级，是重写级迁移
TP5.1 和 TP8.0 的底层差异大到无法“平滑过渡”：PHP 版本要求从 7.1–7.4 变为强制 8.0.2+；路由从注释解析（/** @route */）变成原生 Attribute（#[Route]）；自动加载规则、中间件绑定方式、多模块扫描逻辑全重构。试图复用旧配置或只改 composer.json 版本号，99% 情况下会卡在 Class 'thinkApp' 找不到或路由全部 404。
- 别信“兼容层”或“适配包”——TP8.0 官方不提供 TP5.x 的兼容桥接
- TP5.1 的
app/目录结构（如app/admin/controller）在 TP8.0 中默认不被扫描，必须手动加进annotation.php白名单 -
config/app.php里default_return_type在 TP5.2+ 已默认为json，TP8.0 彻底移除html返回类型支持，所有return $data默认走 JSON，前端若依赖text/html响应会直接乱码
composer install 卡死或报 Class 'SwooleHttpServer' not found
TP8.0 默认引入 topthink/think-swoole，但多数老项目实际跑在 Nginx + PHP-FPM 上，并不需要 Swoole。强行保留这个依赖，就会因扩展缺失或版本错位反复失败。
- 先执行
php -m | grep swoole——没输出就说明没装；有输出再查版本：php --ri swoole | grep Version，PHP 8.0+ 至少要 Swoole 4.8.13+，低于此版本会编译失败 - 如果你的部署环境是传统 FPM，直接删掉
topthink/think-swoole：运行composer remove topthink/think-swoole，然后删掉config/swoole.php和所有php think swoole启动脚本 - 别只删 vendor 里的文件——必须清掉
composer.lock再composer install，否则 Composer 仍会按旧锁文件拉取不兼容依赖
路由 404 或注解完全不生效
TP8.0 的注解路由不是“开箱即用”，它依赖 topthink/think-annotation 扩展主动扫描命名空间。TP5.1 那套自动发现 app/*/controller 的机制在 TP8.0 中已删除。
立即学习“PHP免费学习笔记（深入）”；
- 检查
config/annotation.php，确认'scan' => ['app\controller']是否存在；如果用了多模块（比如app/admin/controller），必须显式加上'app\admin\controller' - 控制器类必须用 PHP 8 原生 Attribute，例如：
#[Route('api/user')]，而不是 TP5.1 的/** @route api/user */——后者会被彻底忽略 - 改完路由后，务必执行
php think clear --all，否则缓存里的旧路由规则还在，新注解永远不生效
数据库连接失败或查询报错
TP8.0 底层驱动全面转向 PDO，且默认禁用 MySQL 的旧认证插件。老项目 config/database.php 里残留的 'type' => 'mysql' 或 'mysqlnd' 会直接导致连接中断。
- 把
'type'改成'pdo_mysql'或'mysqli'，绝不能是'mysql'（该驱动 PHP 8 已移除） - MySQL 8 默认用
caching_sha2_password插件，TP8.0 的 PDO 连接字符串需显式指定：'dsn' => 'mysql:host=127.0.0.1;dbname=test;charset=utf8mb4;auth_plugin=mysql_native_password' - 如果用 Docker，确认 PHP 容器里装了
php-mysql或php-pdo_mysql，Alpine 镜像要用php8-pdo_mysql，不是php7-mysqlnd
真正难的不是让首页跑起来，而是那些没报错但逻辑偏移的地方：比如 Request::param() 在 TP8.0 里对空参数返回 null 而不是空字符串，Db::table()->where('id', null) 生成的 SQL 从 id = NULL 变成 id IS NULL，这些细微变化会让某些条件判断突然失效。上线前，必须逐个验证核心业务路径，而不是只看日志有没有 Fatal Error。
