Swoole的onWorkerError事件在什么情况下触发

onWorkerError事件在Swoole工作进程发生致命错误时触发，用于捕获PHP致命错误、内存耗尽、段错误等导致进程异常终止的情况。1. 触发条件包括PHP致命错误（如调用未定义函数）、内存超限崩溃、C层代码引发的段错误、子进程非正常退出及协程中未被捕获的致命异常。2. 使用场景主要为记录日志和告警，无法恢复已崩溃进程，主进程会自动重启新worker；该回调仅对workerman模式或Task Worker有效，参数包含worker_pid、worker_id、exit_code，可用于问题定位，但不能捕获普通异常。3. 示例代码展示如何注册事件并处理错误，如模拟调用不存在函数触发Fatal Error。onWorkerError是保障服务稳定性的重要兜底机制。

Swoole的onWorkerError事件在工作进程发生致命错误时触发，主要用于捕获进程级别的异常情况，比如PHP致命错误（Fatal Error）、内存耗尽、段错误（Segmentation Fault）等导致工作进程异常终止的场景。

1. 触发条件

以下情况会触发onWorkerError回调：

• PHP致命错误：如调用未定义函数、实例化不存在的类、语法错误（在运行时触发的部分）等。
• 内存超限崩溃：worker进程内存使用超过系统限制或PHP memory_limit设置，导致进程中断。
• 核心转储或段错误：C层代码出错（例如Swoole扩展本身或第三方扩展引发的Segmentation Fault）。
• 子进程异常退出：worker进程非正常退出，exit状态码不为0。
• 协程中未被捕获的致命异常：虽然普通Exception可通过try/catch处理，但某些未处理的致命异常仍可能导致worker终止并触发该事件。

2. 使用场景和注意事项

onWorkerError主要用于记录日志、告警或进行简单的错误追踪，不能恢复已崩溃的进程。Swoole主进程会在worker退出后自动重启一个新的worker进程。

稿定在线PS

PS软件网页版

99

查看详情

• 该回调仅在workerman模式或Task Worker中生效，Master进程自身错误不会触发。
• 参数包含worker_pid、worker_id、exit_code等信息，可用于定位问题。
• 不能用于捕获普通异常（Exception），应使用try/catch或set_exception_handler处理。

3. 示例代码

注册onWorkerError事件：

$server = new Swoole\Server("127.0.0.1", 9501);

$server->on("WorkerError", function ($server, $worker_pid, $worker_id, $exit_code) {
    echo "WorkerError: pid={$worker_pid}, worker_id={$worker_id}, exit_code={$exit_code}\n";
    // 可记录日志或发送告警
});

$server->on("Receive", function ($server, $fd, $reactor_id, $data) {
    // 模拟致命错误
    undefined_function(); // 调用不存在的函数，触发Fatal Error
});

以上就是Swoole的onWorkerError事件在什么情况下触发的详细内容，更多请关注php中文网其它相关文章！