OTTO 是 Square 出品的一个基于反射的事件总线库,曾经在 Android 开发中被广泛使用。随着项目复杂度提升以及新架构的引入,我们决定将它从项目中彻底移除,替换为更可控、更现代的方案。迁移过程并不复杂,但踩到的坑比预想的多。这篇文章把过程中的关键问题和解决思路记录下来,供有类似需求的团队参考。
为什么要迁移
直接原因有三个。第一,OTTO 依赖运行时反射和注解,方法查找在注册阶段完成,事件分发时还要做类型匹配,在事件类型较多、订阅者较多的情况下,性能开销不可忽视。第二,Otto 的提供者机制和事件继承匹配规则容易造成”意外收到事件”,调试成本高。第三,项目正在向更明确的单向数据流演进,事件总线的隐式耦合与这一方向相悖。综合评估后,我们选择了以显式回调、生命周期感知的观察者以及少量必要的消息通道来替代。
坑一:事件继承匹配带来的隐式订阅
Otto 在分发事件时,会把事件分发给参数类型为事件父类或接口的订阅方法。这个特性在早期被当作便利,实际却埋下隐患:订阅了 BaseEvent 的方法会收到所有子类事件,而开发者往往只关注其中一种。迁移时我们逐条梳理了所有 @Subscribe 方法,发现多处订阅实际接收的事件范围远超预期。
处理方式是:先把每个订阅方法的实际入参类型和它真正关心的事件类型列成对照表,再决定新方案中应该监听哪个具体类型。这一步不能省,否则迁移后要么漏收事件,要么继续保留隐式行为。
坑二:注册与反注册的生命周期错配

Otto 要求显式调用 register 和 unregister,一旦漏掉 unregister,订阅者会被总线强引用,造成内存泄漏;反之,如果在错误的生命周期节点 unregister,又会漏收事件。我们在代码里找到若干处在 onCreate 注册、却在 onDestroy 才反注册的写法,还有在 Fragment 的 onCreateView 注册、onDestroyView 未反注册的情况。
- 统一规则:注册与反注册必须成对出现在同一个生命周期边界内,例如 onCreate/onDestroy 或 onStart/onStop。
- 迁移到新方案时,优先使用具备生命周期感知能力的观察者,让框架负责自动解绑,从根上消除漏反注册的可能。
- 对于必须手动管理的通道,封装一个注册辅助类,在内部记录订阅关系,避免散落在业务代码中。
坑三:主线程假设被打破
Otto 默认在发布事件的线程上同步分发。很多代码默认事件都在主线程发出,因此订阅方法里直接操作 UI。迁移过程中,我们把部分事件改由后台线程通过消息通道发出,结果订阅端出现线程异常。这类问题在编译期完全看不出来,只在运行时暴露。
解决思路是明确每个事件的线程契约:要么在发送端统一切换到主线程,要么在接收端显式切回主线程。我们选择在通道封装层声明线程策略,并在代码评审中把”事件在哪个线程分发”作为必查项。
坑四:事件对象被复用导致的状态污染

原代码中有几处为了减少对象分配,复用了同一个事件实例并修改其字段后再发布。Otto 同步分发时这不一定是问题,但新方案中部分通道是异步的,接收方拿到的是同一个可变对象,读到的是被后续修改覆盖后的状态。这类 bug 表现为”偶发拿到错误数据”,极难复现。
修复原则很简单:事件对象一律设计为不可变,字段用 final 修饰,需要变更就新建实例。迁移时我们顺手把几个可变事件类改成了不可变,并补充了构造参数校验。
坑五:测试代码同样依赖总线
单元测试里大量使用 Otto 来模拟事件流,迁移时这部分代码也需要重写。原本通过 post 一个事件就能触发订阅逻辑,现在需要改为直接调用回调或向测试替身注入消息。我们借这次迁移把测试中的事件驱动改成了显式的依赖注入,测试的可读性和稳定性反而提升了。
迁移后的收益与建议
完成迁移后,事件流向变得显式,订阅关系可以在代码中直接追踪,反射带来的性能开销消失,与生命周期相关的泄漏风险也大幅降低。回顾整个过程,有几点建议值得强调:
- 先做订阅关系盘点,再动手改代码,避免边改边漏。
- 把线程契约和对象不可变性写进规范,而不是依赖开发者记忆。
- 分批迁移,按模块切换并保留短期兼容层,降低一次性风险。
- 迁移完成后删除旧依赖和残留注解,防止有人继续按旧方式写代码。
事件总线本身不是问题,问题在于隐式契约难以维护。把隐式变显式,是这次迁移最大的收获。















暂无评论内容