Kotlin Gradle项目重复类错误排查与解决方法咨询

一、定位并解决重复类问题 #

1. 从错误日志直接定位 #

编译时的重复类错误日志会明确给出重复类的全限定名（比如Duplicate class androidx.core.util.SomeClass found in modules core-ktx-1.8.0.jar and core-ktx-1.9.0.jar），根据这个类名能快速锁定冲突的库。

2. 分析依赖树找重复 #

执行Gradle命令查看完整依赖树：

./gradlew app:dependencies

如果输出太冗长，可过滤特定组的依赖缩小范围，比如查找androidx.core相关依赖：

./gradlew app:dependencies | grep "androidx.core"

找到重复引入的依赖后，在对应的依赖项中排除重复模块，比如发现activity-compose自动引入了旧版本core-ktx，可这样处理：

implementation('androidx.activity:activity-compose:1.7.0-alpha04') {
    exclude group: 'androidx.core', module: 'core-ktx'
}

3. 借助Android Studio工具排查 #

打开Project Structure窗口（快捷键Ctrl+Alt+Shift+S），切换到Dependencies标签，搜索疑似重复的库，能直观看到不同依赖引入的版本差异。

二、使用依赖BOM管理依赖（更优方案） #

依赖BOM（Bill of Materials）是官方提供的版本统一管理方案，能自动同步所有相关依赖的版本，从根源避免版本冲突和重复类问题。针对你的Compose项目，修改dependencies块如下：

dependencies {
    // 引入Compose BOM，统一所有Compose相关依赖版本
    implementation platform('androidx.compose:compose-bom:2023.03.00')
    // 引入AndroidX BOM，统一Activity、Lifecycle等组件版本
    implementation platform('androidx.activity:activity-bom:1.7.2')
    implementation platform('androidx.lifecycle:lifecycle-bom:2.6.1')

    // 依赖无需指定版本，由BOM自动匹配兼容版本
    implementation 'com.google.android.gms:play-services-maps:18.1.0'
    implementation 'androidx.core:core-ktx'
    implementation 'androidx.lifecycle:lifecycle-runtime-ktx'
    implementation 'androidx.activity:activity-compose'
    implementation "androidx.compose.ui:ui-tooling"
    implementation "androidx.compose.ui:ui-tooling-preview"
    implementation 'androidx.compose.material3:material3'

    debugImplementation "androidx.compose.ui:ui-tooling"
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
    androidTestImplementation "androidx.compose.ui:ui-test-junit4"
    debugImplementation "androidx.compose.ui:ui-test-manifest"
}

注意事项 #

• 原配置中compose_version变量未定义，使用BOM后无需再维护该变量；
• 避免同时指定BOM和依赖版本，否则会覆盖BOM的版本管理逻辑；
• 优先使用官方提供的BOM（Compose、AndroidX、Material3等），确保依赖版本兼容性。

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