max_coroutine用于限制Worker进程内最大协程数,防止内存耗尽;默认65536,可通过Swoole\Coroutine::set设置;每个协程占8KB栈空间,高并发下需合理配置以避免创建过多协程导致系统不稳定。
max_coroutine
是 Swoole 中用于控制单个 Worker 进程内允许创建的最大协程数量的参数。
Swoole 6.1.1
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版,它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构,内置 TCP/HTTP/WebSocket 服务器,能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
下载
作用说明
当你的 Swoole 服务在处理请求时启用了协程(例如使用创建协程),每个协程都会占用一定的内存和资源。设置max_coroutine可以防止因协程数量过多导致内存耗尽或系统不稳定。
一旦当前进程中的协程数达到这个限制,后续调用创建新协程时会失败,并抛出类似“maximum coroutine count exceeded”的错误。
默认值与配置
从 Swoole 4.5 版本起,max_coroutine的默认值通常是65536(即 6.5 万个协程)。
你可以根据实际需求在启动服务前通过以下方式修改:
通常放在服务启动脚本的开头,确保在任何协程创建之前生效
使用建议
该参数需要根据服务器内存和业务逻辑合理设置:
协程本身较轻量,但每个协程仍会分配栈空间(默认 8KB),大量协程会累积消耗内存
高并发场景下(如大量 HTTP 客户端请求),容易短时间内创建大量协程,需特别注意限制
若频繁遇到“coroutine count exceeded”错误,可适当调大该值,但应结合监控排查是否有协程未正确退出的问题
基本上就这些。合理设置
max_coroutine
能在保证高并发能力的同时,避免系统资源被耗尽。
go()go()Swoole\Coroutine::set(['max_coroutine' => 100000]);