DialogFlow与Firebase共存时protobuf-java与protobuf-javalite类重复报错

冲突原因 #

Firebase Firestore默认依赖protobuf-javalite（面向移动平台优化的轻量实现，类结构与完整版不兼容），DialogFlow官方SDK依赖protobuf-java（标准完整版实现），两者存在大量同包名同类名但内部实现不同的类，因此单纯排除任意一方都会触发运行时错误。

你之前两种方案失败的核心原因：

1. 仅排除protobuf-java后没有补充DialogFlow运行所需的对应类实现，因此抛出类找不到异常
2. 仅排除protobuf-javalite后，Firestore内部代码是针对lite版编译的，和完整版protobuf字节码不兼容，因此抛出字节码校验错误

可行解决方案 #

方案1：全局统一使用protobuf-javalite（推荐，性能更适配移动端） #

• 第一步：在项目根目录的build.gradle中添加全局配置，排除所有场景下的完整版protobuf依赖

configurations.all {
    exclude group: 'com.google.protobuf', module: 'protobuf-java'
    exclude group: 'com.google.protobuf', module: 'protobuf-java-util'
}

• 第二步：在app模块的build.gradle依赖中，引入和Firebase版本对齐的全量lite版protobuf依赖，补齐DialogFlow需要的类

// 版本需要和你的Firebase BoM对应的protobuf版本保持一致，以下为示例版本
implementation "com.google.protobuf:protobuf-javalite:3.21.12"
// 项目使用Kotlin可额外添加以下依赖
implementation "com.google.protobuf:protobuf-kotlin-lite:3.21.12"

• 第三步：调整DialogFlow依赖配置，排除其内部自带的protobuf依赖

implementation("com.google.cloud:google-cloud-dialogflow:4.30.0") {
    exclude group: 'com.google.protobuf'
}

方案2：启用Dex合并规则处理冲突 #

如果方案1不生效，可在app模块的build.gradle的android闭包中添加打包规则，优先保留lite版的类实现

android {
    packagingOptions {
        pickFirst 'com/google/protobuf/*.class'
        pickFirst 'com/google/protobuf/**/*.class'
    }
}

同时在gradle.properties中添加以下配置优化构建合并

android.enableJetifier=true
android.useAndroidX=true
android.enableDexingArtifactTransform=true
android.enableR8.fullMode=true

构建前注意事项 #

• 调整配置后执行Build > Clean Project清除旧构建缓存，避免缓存产物导致的异常
• 确认所有模块的protobuf版本完全对齐，避免版本不一致导致的兼容问题

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