PHP 8.0+ 升级后 ThinkPHP 报 syntax error 是因旧版（TP5.0/5.1）不支持新语法，需升至 TP5.2 或 TP6；Swoole 扩展缺失或版本不匹配、autoload 加载失败、MySQL 8 认证插件不兼容及 config 缓存未清是常见迁移问题。
PHP 版本升级后 thinkphp/framework 报 ParseError: syntax error, unexpected token "string"
这是 PHP 8.0+ 引入的 string 类型声明被旧版 ThinkPHP 解析器误判导致的——老版本框架（如 TP5.0.x / TP5.1.x）源码里有类似 function foo(string $s) 的写法，但其底层反射或类扫描逻辑没适配 PHP 8 的新语法解析规则。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认当前 ThinkPHP 主版本：
composer show topthink/framework，TP5.0/5.1 不支持 PHP 8.0+，必须升到 TP5.2 或 TP6.x - TP5.1 升 TP5.2：改
composer.json中"topthink/framework": "^5.2"，然后composer update topthink/framework，注意config/app.php里default_return_type默认值已从html改为json - 若卡在 TP5.0 且无法升级，临时方案是降级 PHP 到 7.4 —— 但别长期用，PHP 7.4 已 EOL
迁移时 composer install 卡在 topthink/think-swoole 编译失败
TP6 默认集成 Swoole 扩展，但新环境常缺 swoole 扩展或版本不匹配。错误典型表现为 Class 'SwooleHttpServer' not found 或编译报 error: ‘SWOOLE_VERSION_ID’ undeclared。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先查扩展是否加载：
php -m | grep swoole；没输出就说明没装，不是仅pecl install swoole就完事——要确认extension=swoole.so在php.ini对应位置（CLI 和 FPM 的php.ini可能不同） - Swoole 版本需匹配 PHP：PHP 8.2 要 Swoole 5.0+，PHP 7.4 最高只兼容 Swoole 4.8.x；用
php --ri swoole看实际版本 - 若项目其实不用 Swoole（比如只是 Nginx + PHP-FPM），直接删掉
topthink/think-swoole依赖，并清空config/swoole.php和启动脚本里的php think swoole相关调用
vendor/autoload.php 加载失败，Class 'thinkApp' not found
不是自动加载路径错了，而是迁移时漏了 composer dump-autoload 或用了错误的 autoloader 模式。尤其从开发机复制整个 vendor 到生产环境后，composer.lock 和本地 composer.json 不一致时，autoload_classmap.php 会失效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 绝对不要手动复制
vendor文件夹——统一用composer install --no-dev（生产环境）或composer install（开发环境）重建 - 检查
composer.json是否含"autoload": {"psr-4": {"app\": "app/"}}，TP6 默认是app命名空间，但有些老项目自定义成App（首字母大写），会导致类找不到 - 确认入口文件
public/index.php加载的是vendor/autoload.php，而不是某个硬编码路径；常见错误是复制了旧项目的index.php，里面还写着require __DIR__.'/../thinkphp/start.php'
数据库连接从 MySQL 5.7 迁到 MySQL 8.0 后 SQLSTATE[HY000] [1045] Access denied for user
MySQL 8.0 默认改用 caching_sha2_password 认证插件，而 PHP 7.4+ 的 mysqlnd 驱动默认不支持该插件（除非显式启用），ThinkPHP 的 PDO 连接会静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 登录 MySQL 执行：
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass';，强制切回传统认证方式 - 或者在 ThinkPHP 的数据库配置
config/database.php中加参数：'params' => [PDO::ATTR_EMULATE_PREPARES => true]，但这只是绕过，不解决根本 - 更彻底的解法：升级
mysqlnd（PHP 8.0+ 自带支持），并确保连接 DSN 中指定charset=utf8mb4，否则中文字段可能乱码
最麻烦的其实是 config 缓存没清——改完 database.php 后记得 php think clear:config，不然 TP6 会一直读缓存里的旧配置。
