协程内未捕获异常仅终止当前协程而非崩溃进程,必须在每个go()入口显式try-catch并记录上下文,set_exception_handler无效,需配合Scheduler::setExceptionHandler和WorkerError兜底。

协程内未捕获异常会静默终止,不是“抛出即崩”
在 Swoole 协程中,throw 一个未被 try-catch 捕获的异常,不会像同步 PHP 那样导致整个进程崩溃,而是仅终止当前协程。这看似友好,实则危险:错误被吞掉、日志缺失、trace_id 断链、问题难以复现。
典型现象包括:
- HTTP 接口偶发 500 但无日志记录
- 协程执行到一半消失,
Co::getuid()对应的请求上下文丢失 - 使用
Monolog记录时发现部分错误根本没进 handler
根本原因是:Swoole 不会自动将协程异常向上冒泡到 Worker 进程层,必须显式拦截。
必须在每个 go() 入口加 try-catch,不能依赖全局 handler
set_exception_handler() 在协程环境里只对「非协程上下文」生效(比如 WorkerStart 回调),对 go() 或 Co::create() 启动的协程无效。这是最常被忽略的兼容性盲区。
正确做法是把 try-catch 当作协程的“安全壳”:
go(function () {
try {
$ctx = Coroutine::getContext();
$ctx['trace_id'] = $ctx['trace_id'] ?? uniqid('trc_');
// 业务逻辑
$result = callExternalApi();
echo "success: {$result}\n";
} catch (Throwable $e) {
// 必须在此处记录完整上下文
error_log(sprintf(
"[CORO:%d][TRACE:%s] %s in %s:%d\n",
Co::getUid(),
$ctx['trace_id'] ?? 'N/A',
$e->getMessage(),
$e->getFile(),
$e->getLine()
));
// 可选:触发告警或 fallback 响应
}
});
- 不要省略
Throwable,它同时覆盖Exception和Error - 务必读取
Coroutine::getContext(),避免用$GLOBALS或静态属性存 trace_id - 日志内容必须含
Co::getUid(),否则无法关联协程生命周期
WorkerError 回调是最后一道防线,但只捕获进程级崩溃
WorkerError 事件不是用来兜协程异常的——它只在 Worker 进程因致命错误(如段错误、OOM、PHP 扩展崩溃)退出时触发。协程内 throw new Exception 不会触发它。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版,它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构,内置 TCP/HTTP/WebSocket 服务器,能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
但它仍有不可替代的价值:
- 捕获 C 层崩溃(比如 swoole_mysql 扩展内存越界)
- 识别因未释放资源(Redis 连接、文件句柄)导致的进程僵死
- 配合
max_request配置,形成“定期重启 + 异常兜底”双保险
示例配置:
$server->on('WorkerError', function ($server, $workerId, $exitCode, $signal) {
$msg = sprintf("Worker#%d crashed. ExitCode=%d Signal=%d", $workerId, $exitCode, $signal);
file_put_contents('/var/log/swoole_worker_error.log', $msg . "\n", FILE_APPEND);
// 注意:此处不能调用协程 API(如 Co::sleep),因为已不在协程上下文
});
协程专用异常处理器需手动注册,且仅对当前协程有效
Swoole 提供了 Swoole\Coroutine\Scheduler::setExceptionHandler(),但它只作用于当前协程调度器实例,且默认不启用。多数人直接忽略,结果协程崩溃无声无息。
启用方式(推荐放在 WorkerStart 中):
$server->on('WorkerStart', function ($server, $workerId) {
// 为当前 Worker 的协程调度器设置异常处理器
\Swoole\Coroutine\Scheduler::setExceptionHandler(function (Throwable $e) {
error_log("[SCHEDULER_ERR] " . $e->getMessage() . " at " . $e->getFile() . ":" . $e->getLine());
});
});
- 该 handler 仅捕获「调度器内部抛出的异常」,比如协程切换失败、channel 关闭后写入等底层错误
- 它不替代业务层的
try-catch,而是补充——两者必须共存 - 若使用
Co::run()手动启动调度器,需在其中单独调用setExceptionHandler()
真正容易被忽略的点是:协程异常处理没有“全局默认”,每个协程、每个调度器、每个 Worker 都得自己配。靠一个 set_exception_handler() 想一劳永逸,注定漏掉 80% 的错误现场。










