Guava EventBus 注册 Activity 在低版本 Android 上引发 NoClassDefFoundError

背景

在近期的一次项目依赖升级（主要涉及 AndroidX 相关库的升级）后，并在上线前的兼容测试中，发现低版本设备（Android 11 及以下）出现稳定崩溃，而升级前一切正常。高版本设备无异常。崩溃入口直指 Guava EventBus 的 register() 调用。

现象

崩溃日志：

com.google.common.util.concurrent.ExecutionError:
  java.lang.NoClassDefFoundError: Failed resolution of: Landroid/app/PictureInPictureUiState;
    at com.google.common.eventbus.EventBus.register(EventBus.java)
    at cn.example.utils.EventBusCenter.register(EventBusCenter.kt:7)
    at cn.example.ui.SomeActivity.onCreate(SomeActivity.kt)

EventBusCenter 的实现非常简单：

object EventBusCenter {
    val instance = EventBus()

    fun register(obj: Any?) {
        instance.register(obj)  // 第 7 行
    }
    // ...
}

崩溃发生在 register() 的第 7 行，即 Guava EventBus 执行注册逻辑期间。

原因分析

这个崩溃涉及三个环节的叠加。

1. `PictureInPictureUiState` 是 API 31 新增的类

android.app.PictureInPictureUiState 在 Android 12（API 31）中引入，ComponentActivity（所有 Activity 的祖先类）新增了一个回调方法：

// ComponentActivity — API 31 新增
public void onPictureInPictureUiStateChanged(PictureInPictureUiState transientUiState) { }

低版本设备上这个类根本不存在，任何触发其加载的行为都会抛出 NoClassDefFoundError。

2. Guava EventBus 使用反射全量扫描订阅者

EventBus.register(subscriber) 内部通过 SubscriberRegistry 扫描订阅者的整个类继承链：

// Guava SubscriberRegistry 核心逻辑（简化）
Set<Class<?>> supertypes = TypeToken.of(clazz).getTypes().rawTypes();
for (Class<?> supertype : supertypes) {
    for (Method method : supertype.getDeclaredMethods()) {
        // 查找 @Subscribe 注解方法
    }
}

触发 getDeclaredMethods() 时，ART 会对类进行字节码验证，尝试解析其方法签名中涉及的所有类型。

3. 直接注册 Activity 本身——原始代码

原始代码是将 @Subscribe 方法直接写在 Activity 上，并将 Activity 本身传给 EventBus.register()：

// ❌ 原始代码：直接注册 Activity 自身
class SomeActivity : AppCompatActivity() {

    @Subscribe
    fun onMessageEvent(event: String) {
        // ...
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        EventBusCenter.register(this)  // 注册 Activity 自身
    }

    override fun onDestroy() {
        super.onDestroy()\
        EventBusCenter.unregister(this)
    }
}

当 EventBus 对 SomeActivity 执行扫描时，TypeToken.getTypes() 会遍历其整个父类链（AppCompatActivity → FragmentActivity → ComponentActivity → ...），getDeclaredMethods() 遭遇 onPictureInPictureUiStateChanged(PictureInPictureUiState) 后尝试加载 PictureInPictureUiState，在低版本设备上直接崩溃。

崩溃链路

EventBus.register(this)
  → SubscriberRegistry 扫描订阅者类
    → ART 遍历 SomeActivity 整个父类链
      → ComponentActivity.onPictureInPictureUiStateChanged(PictureInPictureUiState) ← API 31
        → NoClassDefFoundError（低版本设备无此类）

正确修复——静态嵌套类

将 subscriber 移到 companion object 内，成为静态嵌套类（等价于 Java static 嵌套类）。静态嵌套类不持有外部类引用，ART 加载时完全隔离于外部 Activity 及其父类链。

companion object {
    /**
     * Guava EventBus 静态订阅者类。
     * 必须是静态嵌套类（companion object 内），而不是匿名内部类。
     * 匿名内部类持有外部 Activity 引用，ART 验证时会沿引用链解析到
     * ComponentActivity.onPictureInPictureUiStateChanged(PictureInPictureUiState)，
     * 在低版本设备（< API 31）上引发 NoClassDefFoundError。
     */
    class EventBusSubscriber(private val callback: () -> Unit) {
        @Subscribe
        fun onMessageEvent(event: String) {
            callback()
        }
    }
}

// 使用 lambda 传递业务逻辑，与 Activity 解耦
private val eventBusSubscriber = EventBusSubscriber {
    // 具体操作
}

修复前后对比

	原始代码	修复后
注册对象	`this`（Activity 本身）	`companion object` 内静态嵌套类
EventBus 扫描范围	Activity 完整父类链	仅 `EventBusSubscriber` 本身
低版本兼容性	❌ 崩溃	✅ 安全

延伸：哪些场景会有类似风险？

对于所有使用反射扫描订阅者类的框架，都可能触发此类问题：

Guava EventBus — EventBus.register()
Otto EventBus — Bus.register()（已停止维护）
自定义注解处理框架 — 任何调用 getDeclaredMethods() / getMethods() 的地方

规避原则：把传给反射框架的对象提取为静态嵌套类，让它不对外部类产生隐式依赖。

总结

环节	问题
`PictureInPictureUiState`	API 31 新增，低版本设备不存在
Guava EventBus 反射	`getDeclaredMethods()` 触发 ART 类验证，遍历整个父类链
直接注册 Activity	EventBus 直接扫描 Activity 继承链，触及 API 31 的类
匿名 `object` 内部类	生成非静态内部类，ART 加载时仍会验证外部 Activity
正确修复	改用 `companion object` 内的静态嵌套类，斩断引用链

这个崩溃的特殊之处在于：业务代码本身没有直接引用 PictureInPictureUiState，问题来自反射框架的类扫描行为与编译器生成的内部类结构之间的隐式联动，且第一次”看起来合理”的修复仍然无效，必须理解内部类与静态嵌套类在 ART 类加载上的本质区别才能彻底解决。

背景

现象