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

max_coroutine 是 Swoole 中用于控制单个 Worker 进程内允许创建的最大协程数量的参数。

阿里云-虚拟数字人

阿里云-虚拟数字人是什么？ …

2

查看详情

作用说明

当你的 Swoole 服务在处理请求时启用了协程（例如使用 go() 创建协程），每个协程都会占用一定的内存和资源。设置 max_coroutine 可以防止因协程数量过多导致内存耗尽或系统不稳定。 一旦当前进程中的协程数达到这个限制，后续调用 go() 创建新协程时会失败，并抛出类似“maximum coroutine count exceeded”的错误。

默认值与配置

从 Swoole 4.5 版本起，max_coroutine 的默认值通常是 65536（即 6.5 万个协程）。 你可以根据实际需求在启动服务前通过以下方式修改：

• SwooleCoroutine::set(['max_coroutine' => 100000]);
• 通常放在服务启动脚本的开头，确保在任何协程创建之前生效

使用建议

该参数需要根据服务器内存和业务逻辑合理设置：

• 协程本身较轻量，但每个协程仍会分配栈空间（默认 8KB），大量协程会累积消耗内存
• 高并发场景下（如大量 HTTP 客户端请求），容易短时间内创建大量协程，需特别注意限制
• 若频繁遇到“coroutine count exceeded”错误，可适当调大该值，但应结合监控排查是否有协程未正确退出的问题

基本上就这些。合理设置 max_coroutine 能在保证高并发能力的同时，避免系统资源被耗尽。