ThinkPHP 8.x 不能直接跑在 Swoole 5.x 上，因默认依赖的 think-swoole v3 仅兼容 Swoole 4.8–4.10，需升级至 v4.0.0+ 才支持 Swoole 5。
ThinkPHP 8.x 能不能直接跑在 Swoole 5.x 上？
不能，会启动失败。核心原因是 think-swoole 扩展从 v4 开始才正式支持 Swoole 5，而 TP8 默认依赖的 think-swoole v3 只兼容 Swoole 4.8–4.10。你看到的 SWOOLE_VERSION 不匹配、Swoole\Server 类找不到或 Coroutine::create() 报错，基本都卡在这儿。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- TP8 + Swoole 5 → 必须升级
think-swoole到v4.0.0+，同时确认项目中没手动 newSwoole\Server - TP6.1–6.3 + Swoole 5 → 同样需升
think-swoole到 v4，但要注意 TP6 的Container初始化时机和协程上下文隔离问题 - 如果用的是 Swoole 4.8（如 CentOS 7 默认源），TP6/TP8 都可配
think-swoolev3.5.2，更稳
为什么 Db::transaction() 在 Swoole 协程里会锁表或死锁？
因为 ThinkPHP 默认的 PDO 连接不是协程安全的，Db::transaction() 底层仍走同步阻塞 IO，在协程环境下多个请求共用一个连接句柄，事务状态互相污染。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 必须启用协程 MySQL 客户端：安装
swoole时开启--enable-mysqlnd，并在database.php中把type改成'mysql'（不是'pdo'） - 连接池配置不能省：
'pool' => ['min' => 5, 'max' => 30]，否则高并发下连接耗尽，beginTransaction()会卡住 - 避免在事务中调用
sleep()、file_get_contents()等同步操作，协程会退化为单线程执行
think-swoole 的 server.type 设为 http 还是 websocket？
看入口协议，不看业务逻辑复杂度。HTTP 服务只响应 GET/POST 请求，WebSocket 服务必须走 ws:// 握手，两者底层事件循环和生命周期完全不同。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 纯 API 接口（含 JWT 鉴权、文件上传）→ 选
http，配合onRequest回调，TP 的中间件、路由全可用 - 需要长连接推送（如消息通知、实时订单）→ 单独起一个
websocketserver，别和 HTTP 混用；onMessage里不能直接调Loader::import() - 改了
server.type必须清空runtime/swoole/下所有 PID 和日志文件，否则旧进程残留导致端口占用或配置不生效
TP8 的 console 命令在 Swoole 下为什么执行完不退出？
因为 think-swoole v4 启动后会接管 PHP 生命周期，即使你只运行 php think hello，Swoole 的事件循环也会被意外激活，进程挂起等连接。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 所有命令行操作前加环境变量：
SWOOLE_CLI=0 php think hello，这是最轻量的绕过方式 - CI/CD 脚本里禁止用
php think启动定时任务，改用系统 cron +curl http://127.0.0.1:9501/api/cron - 如果非要内置调度，得在
command.php里判断：if (defined('SWOOLE_VERSION') && !getenv('SWOOLE_CLI')) { exit(); }
协程上下文切换比想象中更敏感，一个未关闭的 Channel 或忘了 go() 包裹的异步调用，就可能让整个 worker 进程卡住不动——这不是 TP 的 Bug，是 Swoole 的运行模型决定的。
