升级Firebase依赖后出现QueryListenOptions类找不到异常

这个问题我之前帮同事排查过，核心原因就是你的Firebase各组件版本不统一导致的！当你同时引入com.google.firebase:firebase-firestore:16.0.0和一堆15.x版本的其他Firebase组件时，不同版本依赖的Firebase核心库存在差异，就会出现类找不到的异常——QueryListenOptions是Firestore组件里的类，由于版本不匹配，类加载路径出现冲突，最终抛出ClassNotFoundException。

解决步骤： #

• 统一所有Firebase组件的版本号：Firebase官方明确要求所有firebase-*组件必须使用相同的版本，这样才能保证内部依赖的一致性。把你所有的Firebase依赖都改成同一个版本（建议和Firestore的16.0.0保持一致，或者直接升级到最新稳定版）。
• 用Gradle变量管理版本号：为了避免后续再出现版本不一致的问题，可以在Gradle里定义统一的版本变量，方便维护。

举个具体的修改例子：
原来的依赖写法：

implementation 'com.google.firebase:firebase-firestore:16.0.0'
implementation 'com.google.firebase:firebase-auth:15.1.0'
implementation 'com.google.firebase:firebase-database:15.0.0'
implementation 'com.google.firebase:firebase-storage:15.0.2'
implementation 'com.google.firebase:firebase-appindexing:15.0.0'
implementation 'com.google.firebase:firebase-messaging:15.0.2'

改成统一版本后的写法：

// 在模块的build.gradle顶部定义版本变量
ext {
    firebaseVersion = '16.0.0'
}

// 依赖部分统一使用变量
implementation "com.google.firebase:firebase-firestore:$firebaseVersion"
implementation "com.google.firebase:firebase-auth:$firebaseVersion"
implementation "com.google.firebase:firebase-database:$firebaseVersion"
implementation "com.google.firebase:firebase-storage:$firebaseVersion"
implementation "com.google.firebase:firebase-appindexing:$firebaseVersion"
implementation "com.google.firebase:firebase-messaging:$firebaseVersion"

• 排查间接依赖冲突：如果统一版本后还是有问题，大概率是第三方库间接引入了旧版本的Firebase组件。可以用Gradle的依赖分析命令找出冲突来源：

# 替换app为你的模块名称
./gradlew app:dependencyInsight --dependency com.google.firebase:firebase-core

找到冲突的依赖后，在对应的第三方库依赖里加上exclude排除旧版本，比如：

implementation('com.example:some-third-party-lib:1.0.0') {
    exclude group: 'com.google.firebase', module: 'firebase-core'
}

只要把所有Firebase组件的版本统一，这个ClassNotFoundException问题基本就能解决啦！

内容的提问来源于stack exchange，提问作者Subratsss