在分布式系统与事件驱动架构中,OTTO 作为一个轻量级的事件总线,被广泛用于组件之间的解耦通信。然而,事件总线的“松耦合”特性也带来了一个容易被忽视的问题:错误处理。当事件发布者不知道谁是订阅者,订阅者也不知道事件从何而来时,一次失败的订阅处理该如何被感知、被记录、被补偿?如果缺乏统一的设计原则,错误很容易被吞掉,最终演变成难以排查的线上故障。本文围绕 Otto 错误处理的核心原则展开,并给出可直接参考的示例。
一、为什么 Otto 的错误处理容易被忽视
Otto 的典型用法是注册订阅者、发布事件,然后由总线异步或同步地分发。问题在于,事件发布动作本身通常不返回订阅者的处理结果。发布者调用 Post 之后,拿到的往往只是一个“是否成功分发”的信号,而不是“每个订阅者是否处理成功”的反馈。这就造成两个常见误区:
- 把“分发成功”等同于“处理成功”:事件已经投递出去,但订阅者内部抛出的异常可能被静默捕获或直接中断后续订阅者。
- 在订阅者内部随意 recover:每个订阅者各写一套 recover 逻辑,日志格式不统一,错误上下文丢失,排查成本极高。
因此,Otto 的错误处理不能依赖“发布者检查返回值”这种直觉,而需要在总线层面建立明确的约定。
二、四条核心设计原则

原则一:订阅者必须自己兜底,异常不得穿透总线
订阅者是被动的接收方,它无法假设发布者会为自己处理异常。因此,每个订阅处理方法都应当在入口处包裹 recover,确保任何 panic 都不会穿透到总线分发循环中。一旦穿透,轻则影响同一事件的其他订阅者,重则导致整个分发协程崩溃。
原则二:错误必须携带上下文,而不是只记录一句“出错了”
一条有价值的错误日志至少应包含:事件类型、订阅者标识、关键业务字段、错误堆栈。缺少上下文的日志在事件总线场景下几乎无法定位问题,因为你无法从海量事件中还原当时的数据状态。
原则三:区分“可重试错误”与“不可重试错误”
并非所有失败都值得重试。网络抖动、下游临时不可用属于可重试;参数校验失败、业务规则拒绝属于不可重试。订阅者应当在错误分类上做出判断,避免对不可重试错误反复重放,造成更大的副作用。
原则四:提供统一的错误上报出口
与其让每个订阅者各自决定把错误写到哪里,不如在总线封装层提供一个统一的错误处理器接口。订阅者只需把错误交给这个出口,由它负责日志、指标、告警或写入死信队列。这样既保证了格式统一,也便于后续扩展。
三、示例:一个带错误处理的订阅者封装
下面的示例展示了一个通用的订阅者包装函数。它接收业务处理函数,返回一个符合 Otto 订阅签名的方法,并在内部完成 recover、上下文补充与错误上报。
包装函数的核心逻辑:首先通过 defer 注册 recover,捕获 panic 后转换为 error;其次在调用业务函数前记录事件类型与订阅者名称;最后无论成功失败,都把结果交给统一的错误处理器。业务函数本身只需要关注正常流程,返回 error 即可,不必重复写 recover。
业务订阅者的写法:订阅者方法只做三件事——解析事件负载、执行业务逻辑、返回错误。它不关心日志格式,也不关心错误最终去向。这种写法让业务代码保持干净,同时保证错误不会丢失。
错误处理器的实现:处理器内部根据错误类型分流。对于可重试错误,写入重试队列并附带重试次数;对于不可重试错误,记录结构化日志并触发告警;对于 panic 转换而来的错误,额外标记为“严重”级别,因为 panic 通常意味着代码缺陷而非外部依赖问题。
四、几个容易踩坑的细节

- 同步分发与异步分发的差异:同步分发时,订阅者的耗时和异常会直接影响发布者;异步分发时,异常发生在另一个协程中,更容易被遗漏。两种模式都应走同一套错误出口。
- 避免在 recover 中再次 panic:错误处理器自身必须足够健壮,写入日志或队列失败时应当降级为本地打印,而不是让 recover 逻辑再次崩溃。
- 控制错误日志的基数:同一事件的高频失败可能瞬间刷爆日志。建议在错误处理器中加入采样或聚合,按“事件类型 + 错误类型”维度合并统计。
- 不要吞掉错误只打日志:如果业务上需要补偿,日志是不够的,必须进入重试或死信通道,否则错误只是“被看见”而没有被“被处理”。
五、小结
Otto 的错误处理本质上是一个约定问题:总线负责分发,订阅者负责兜底,统一出口负责记录与分流。把 recover、上下文、错误分类和上报出口这四件事做成标准封装,业务订阅者就能回归纯粹的業務逻辑,而系统也获得了可观测、可补偿的错误处理能力。事件总线的松耦合不应以牺牲错误可见性为代价,恰恰相反,越是解耦的架构,越需要明确的错误处理契约。















暂无评论内容