Android Studio新建底部导航视图项目出现重复类错误怎么解决

问题原因 #

你的项目出现了 Kotlin 标准库版本冲突：kotlin-stdlib:1.8.20 和 kotlin-stdlib-jdk8:1.6.21 两个模块包含重复的类定义，导致构建失败。这是由于不同依赖项自动引入了不一致的 Kotlin 版本造成的。

解决方案 #

方案一：强制统一 Kotlin 依赖版本 #

在模块级的 build.gradle 文件中添加版本解析策略，强制所有 Kotlin 相关依赖使用同一版本：

dependencies {
    // 保留你原有的依赖配置
    implementation libs.appcompat
    implementation libs.material
    implementation libs.constraintlayout
    implementation libs.lifecycle.livedata.ktx
    implementation libs.lifecycle.viewmodel.ktx
    implementation libs.navigation.fragment
    implementation libs.navigation.ui
    testImplementation libs.junit
    androidTestImplementation libs.androidx.test.ext.junit
    androidTestImplementation libs.espresso.core

    // 添加版本统一策略
    configurations.all {
        resolutionStrategy {
            force "org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.20"
        }
    }
}

方案二：使用 Kotlin BOM 统一版本 #

通过 Kotlin BOM（物料清单）自动对齐所有 Kotlin 库的版本，彻底避免版本冲突：

dependencies {
    // 先添加 Kotlin BOM
    implementation platform("org.jetbrains.kotlin:kotlin-bom:1.8.20")
    
    // 保留你原有的依赖配置
    implementation libs.appcompat
    implementation libs.material
    implementation libs.constraintlayout
    implementation libs.lifecycle.livedata.ktx
    implementation libs.lifecycle.viewmodel.ktx
    implementation libs.navigation.fragment
    implementation libs.navigation.ui
    testImplementation libs.junit
    androidTestImplementation libs.androidx.test.ext.junit
    androidTestImplementation libs.espresso.core
}

方案三：检查版本目录文件 #

如果你使用版本目录（gradle/libs.versions.toml），确保其中的 Kotlin 版本设置完全一致：
打开项目根目录下的 gradle/libs.versions.toml，修改内容如下：

[versions]
kotlin = "1.8.20"

[libraries]
# 确保所有 Kotlin 相关依赖引用同一版本
kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" }
kotlin-stdlib-jdk8 = { module = "org.jetbrains.kotlin:kotlin-stdlib-jdk8", version.ref = "kotlin" }

验证操作 #

修改完成后，点击 Android Studio 工具栏的 Sync Project with Gradle Files 按钮同步配置，然后重新构建项目即可解决冲突。

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