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进程。
- 该回调仅在workerman模式或Task Worker中生效，Master进程自身错误不会触发。
- 参数包含worker_pid、worker_id、exit_code等信息，可用于定位问题。
- 不能用于捕获普通异常（Exception），应使用try/catch或set_exception_handler处理。
3. 示例代码
注册onWorkerError事件：
$server = new SwooleServer("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 });
基本上就这些。onWorkerError是监控Swoole服务稳定性的重要手段，适合做兜底错误收集。
以上就是Swoole的onWorkerError事件在什么情况下触发的详细内容，更多请关注php react workerman 状态码 自动重启 swoole php swoole try catch Error 事件 Workerman