Flutter报checkDebugDuplicateClasses及Kotlin版本不兼容错误如何解决

数据老陈

2026-10-2

问题解决方案

第一步：解决ListenableFuture重复类冲突
打开你的项目下android/app/build.gradle文件，在android配置节点的外部添加如下配置，全局排除冲突的listenablefuture独立包：
```
configurations {
    all*.exclude group: 'com.google.guava', module: 'listenablefuture'
}
```
如果上述配置不生效，可以在同文件的dependencies节点内强制指定统一的guava版本，避免版本混乱：
```
dependencies {
    implementation 'com.google.guava:guava:30.1.1-android'
    // 原有其他依赖保持不变
}
```
第二步：校验Kotlin版本一致性
确认android/app/build.gradle文件中的kotlin标准库依赖版本和根目录build.gradle的ext.kotlin_version保持一致，如果你文件里有如下配置，确保使用变量引用，不要写死低版本：
```
implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
```
第三步：固定非空安全依赖版本
你当前pubspec中很多依赖使用了any标识，可能拉取到需要空安全的高版本导致额外冲突，建议把核心依赖固定到非空安全的兼容版本，比如：
```
firebase_core: ^1.20.0 # 1.x最终版本，适配非空安全
google_sign_in: ^5.4.0
shared_preferences: ^2.0.20 # 兼容非空安全的最后版本
```
第四步：清理缓存重新构建
依次执行以下命令清理缓存后再运行项目：
```
flutter clean
# 手动删除android文件夹下的.gradle隐藏文件夹
flutter pub get
```