不能直接在 FPM 下用 Swoole 提升并发，必须切换运行模型；否则所有协程、多进程、常驻内存特性全部失效，还可能报错，因为 FPM 每次请求都是全新进程、无事件循环，php artisan serve 也不支持协程调度，导致 go()、Coroutine\MySQL 等调用失败或 WebSocket 断连。
不能直接在 FPM 下用 Swoole 提升并发，必须切换运行模型；否则所有协程、多进程、常驻内存特性全部失效，还可能报错。
为什么 php artisan serve 或 FPM 下调用 Swoole 会失败
Swoole 的 go()、Swoole\Coroutine\MySQL、Swoole\Http\Server 等能力依赖事件循环和常驻进程上下文。FPM 每次请求都是全新进程，无事件循环；php artisan serve 是 Symfony 的小服务器，也不支持协程调度。
典型错误包括：
Fatal error: Uncaught Swoole\Error: must be called in the coroutine-
Call to undefined function Swoole\Coroutine\run()（扩展未启用或 CLI 模式未加载） - WebSocket 连接立即断开，日志里没有 handshake 记录
验证是否就绪：
- 运行
php -m | grep swoole，必须有输出 - 确认当前 PHP CLI 使用的
php.ini启用了swoole.so - 不要在
.env里配APP_ENV=local就以为能开发协程逻辑——环境变量不等于运行模型
Octane 启动后仍没并发提升？检查这三处配置
很多人跑 php artisan octane:start 就以为“开了 Swoole”，但默认 fallback 到 frankenphp（Laravel 12+），它不支持协程 IO 和自定义 worker 数。真正发挥 Swoole 多进程能力，必须显式指定并调优：
- 修改
config/octane.php：'server' => 'swoole'（不是frankenphp或roadrunner） -
'workers' => 4—— 对应 CPU 核心数，不是越多越好；超配会导致上下文切换开销反升 -
'concurrent_requests' => 100—— 这是每个 worker 内可并发的协程数，不是总并发值；总并发 ≈workers × concurrent_requests
启动命令必须带参数：php artisan octane:start --workers=4 --max-requests=1000。漏掉 --workers，Octane 就只起 1 个 worker，四核 CPU 白跑三核。
协程 IO 不生效？90% 是因为用了错的客户端
协程不是魔法开关。你在 go() 里写 file_get_contents()、curl_exec() 或 DB::table()->get()，它们仍是同步阻塞调用，协程立刻让出控制权，但底层还是串行发请求——性能比不用协程还差（多了调度开销）。
必须换为协程化客户端：
- HTTP 请求：用
Swoole\Coroutine\Http\Client，别用 Guzzle 默认的 cURL handler - MySQL 查询：用
Swoole\Coroutine\MySQL，不是PDO或 Eloquent 原生驱动 - Redis 操作：用
Swoole\Coroutine\Redis，不是Predis或phpredis的普通连接
注意连接复用：new Swoole\Coroutine\Redis() 每次都新建 TCP 连接，100 个协程 = 100 个 Redis 连接。正确做法是提前 $redis->connect()，再 use ($redis) 传入协程闭包。
多进程下数据库/缓存连接爆满？连接池不是可选项
开 4 个 Octane worker，默认每个 worker 初始化 10 个 MySQL 连接 → 数据库瞬间收到 40 个连接。加上 Nginx + FPM 的连接，MySQL 很快报 Too many connections。
Laravel 不自动做连接池，必须手动配：
- MySQL：在
config/database.php的mysql配置里加'pool' => ['min_connections' => 4, 'max_connections' => 32]（仅 Swoole/RoadRunner 有效） - Redis：用
predis/predis+swooletw/laravel-swoole的连接工厂，或部署twemproxy做代理层 - 切勿在
.env里设DB_CONNECTION=sqlite测试——SQLite 不支持多进程并发写，会锁死
连接池配置后，还要配合 max_requests 定期重启 worker，防止连接泄漏累积。这点容易被忽略：连接池能复用，但不会自动回收异常断连，得靠进程轮替兜底。
