max_coroutine用于限制Worker进程内最大协程数,防止内存耗尽;默认65536,可通过Swoole\Coroutine::set设置;每个协程占8KB栈空间,高并发下需合理配置以避免创建过多协程导致系统不稳定。

max_coroutine 是 Swoole 中用于控制单个 Worker 进程内允许创建的最大协程数量的参数。
对于一个刚进入PHP 开发大门的程序员,最需要的就是一本实用的开发参考书,而不仅仅是各种快速入门的only hello wold。在开发的时候,也要注意到许多技巧和一些“潜规则”。PHP是一门很简单的脚本语言,但是用好它,也要下功夫的。同时,由于PHP 的特性,我一再强调,最NB 的PHP 程序员都不是搞PHP 的。为什么呢?因为PHP 作为一种胶水语言,用于粘合后端 数据库和前端页面,更多需
作用说明
当你的 Swoole 服务在处理请求时启用了协程(例如使用go() 创建协程),每个协程都会占用一定的内存和资源。设置 max_coroutine 可以防止因协程数量过多导致内存耗尽或系统不稳定。
一旦当前进程中的协程数达到这个限制,后续调用 go() 创建新协程时会失败,并抛出类似“maximum coroutine count exceeded”的错误。
默认值与配置
从 Swoole 4.5 版本起,max_coroutine 的默认值通常是 65536(即 6.5 万个协程)。 你可以根据实际需求在启动服务前通过以下方式修改:Swoole\Coroutine::set(['max_coroutine' => 100000]);- 通常放在服务启动脚本的开头,确保在任何协程创建之前生效
使用建议
该参数需要根据服务器内存和业务逻辑合理设置:- 协程本身较轻量,但每个协程仍会分配栈空间(默认 8KB),大量协程会累积消耗内存
- 高并发场景下(如大量 HTTP 客户端请求),容易短时间内创建大量协程,需特别注意限制
- 若频繁遇到“coroutine count exceeded”错误,可适当调大该值,但应结合监控排查是否有协程未正确退出的问题









