QPS卡在1200说明协程未真正生效，需排查I/O调用、上下文隔离与连接复用：先验证swoole协程和hook是否启用，再强制替换阻塞IO为协程客户端，重置超全局变量并禁用自动Session，最后配置数据库与Redis连接池，关闭MySQL wait_timeout，并禁用PDO模式下的Db::transaction()。
在ThinkPHP项目中启用Swoole协程后QPS仍卡在1200左右，说明协程未真正生效或存在隐性阻塞点；必须逐层排查I/O调用、上下文隔离与连接复用三个关键环节，否则再多的worker_num配置也无济于事。
确认协程是否真实启用
第一步：执行php --ri swoole | grep coroutine，输出必须含coroutine => enabled且hook => enabled两行，缺一不可。
第二步：在server.php的WorkerStart回调中插入Swoole\Runtime::enableCoroutine(SWOOLE_HOOK_ALL)，不能只写SWOOLE_HOOK_PDO——【PDO Hook仅对新创建连接生效，若框架提前硬建了PDO实例，协程化直接失效】。
第三步：在任意控制器中调用var_dump(Swoole\Coroutine::getPcid())，返回非null值才表示当前确实在协程内执行。
立即学习“PHP免费学习笔记（深入）”；
替换所有阻塞式I/O调用
方法一：数据库访问必须弃用Db::table()->select()这类同步链式调用。改用go(function() { $mysql = new Swoole\Coroutine\MySQL(); $mysql->connect([...]); $mysql->query('SELECT * FROM user'); });。
方法二：HTTP请求禁用file_get_contents和GuzzleHttp\Client默认同步模式。改用Swoole\Coroutine\Http\Client，注意设置$client->set(['timeout' => 3])避免协程无限挂起。
方法三：Redis操作必须切换为Swoole\Coroutine\Redis驱动，原生Redis扩展即使开启Hook也无法协程化——【Swoole的Redis协程客户端是独立实现，不依赖PHP原生扩展】。
强制隔离协程上下文
① 在onRequest回调开头立即重置超全局变量：$_GET = $request->get ?: []; $_POST = $request->post ?: []; $_SERVER = $request->server;
② 禁用自动Session启动：ini_set('session.auto_start', 0)，改为手动控制：session_id($request->cookie('PHPSESSID') ?: uniqid()); session_start();
③ 每次响应结束前必须调用session_write_close()，否则后续协程会因文件锁阻塞——这是ThinkPHP在Swoole环境下Session失效的最常见原因。
④ 所有静态属性、单例对象（如Container::getInstance()->get('request')）必须通过Swoole\Coroutine\Context::set()注入协程专属实例，否则多个请求共享同一内存地址会导致数据污染。
配置连接池杜绝连接爆炸
安装topthink/think-swoole后，在config/swoole.php中添加数据库池配置：'pool' => ['min_connections' => 5, 'max_connections' => 50]。
Redis连接池需单独初始化：在WorkerStart中执行$redis = new Swoole\Coroutine\Redis(); $redis->connect('127.0.0.1', 6379);，再将实例存入容器供业务调用。
务必关闭MySQL的wait_timeout自动断连机制，服务端设置SET GLOBAL wait_timeout = 28800，防止协程复用空闲连接时遭遇MySQL server has gone away错误。
规避事务与连接池冲突
方法一：彻底禁用Db::transaction()，改用$db->startTrans()→$db->commit()组合，该接口在think-swoole v4+中已适配协程MySQL对象。
方法二：若必须使用嵌套事务，需确保每次startTrans()都在同一协程内完成，跨协程调用commit()会触发Cannot use object of type Swoole\Coroutine\MySQL as resource致命错误。
方法三：检查config/database.php中是否误设'use_pdo' => true，PDO模式下事务控制权移交至PHP层，与协程MySQL对象完全不兼容。
