Workerman自定义错误处理需在start.php顶部、Worker::runAll()前设置set_exception_handler捕获未兜住异常，并用set_error_handler将PHP错误转为ErrorException；Webman中通过config/exception.php配置CustomHandler类接管异常；主进程也需设异常处理器，且回调中避免触发新异常并记录debug_backtrace上下文。
Workerman自定义错误处理需要捕获未被业务代码try-catch兜住的异常，否则这些异常会直接终止Worker进程并暴露原始堆栈给客户端。
设置全局异常处理器
在Workerman启动文件（如start.php）最顶部引入后、Worker::runAll()之前，调用PHP原生set_exception_handler函数：
set_exception_handler(function (Throwable $e) {
error_log('[Uncaught Exception] ' . $e->getMessage() . ' in ' . $e->getFile() . ':' . $e->getLine());
// 此处可写入日志文件、上报Sentry或发送告警
});
这一步必须放在Worker实例创建前，否则Worker内部初始化时抛出的异常无法被捕获。
统一接管所有错误类型
PHP错误（如E_WARNING、E_NOTICE）默认不会触发set_exception_handler，需额外用set_error_handler将其转为ErrorException：
set_error_handler(function ($severity, $message, $file, $line) {
if (!(error_reporting() & $severity)) {
return;
}
throw new ErrorException($message, 0, $severity, $file, $line);
});
注意：该转换只对非致命错误生效；E_PARSE、E_COMPILE_ERROR等编译期错误仍会直接中断脚本，无法捕获。
在Webman中替换默认异常处理器
Webman框架已封装异常处理流程，直接修改config/exception.php即可：
方法一：继承框架Handler并重写render方法
创建app/exception/CustomHandler.php：
class CustomHandler extends \support\exception\Handler {
public function render($request, Throwable $e): Response {
if ($e instanceof \Workerman\Connection\ConnectionException) {
return response()->json(['code' => 503, 'msg' => '服务暂时不可用'], 503);
}
return parent::render($request, $e);
}
}
方法二：完全自定义处理器类
在config/exception.php中注册：
return [
'' => app\exception\CustomHandler::class,
];
【必须确保CustomHandler类已正确声明命名空间并能被自动加载】
捕获Worker进程级崩溃异常
第一步：确认主进程是否启用异常捕获
在start.php中检查是否已设置：
if (Worker::$pid === Worker::$masterPid) {
set_exception_handler(...); // 主进程也要设，否则master崩溃无日志
}
第二步：避免在异常处理器中触发新异常
禁止在set_exception_handler回调里调用可能失败的函数（如file_put_contents未检查磁盘空间、curl请求超时），否则会导致进程静默退出。
第三步：记录原始上下文信息
在异常处理器内添加：
$context = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 10);
error_log('Backtrace: ' . json_encode($context));
这能保留异常发生前最近10层调用链，比单靠$e->getTraceAsString()更利于定位异步场景下的问题。
