Android Studio仅Debug构建时出现kotlin.*重复类问题

当选择Debug变体执行Build --> Rebuild Project时，出现大量Kotlin类重复错误，涉及kotlin-stdlib-1.8.22与低版本kotlin-stdlib-jdk7/jdk8-1.6.21的冲突。但Release变体Rebuild正常，Debug变体直接Run也能运行。使用环境：Android Studio Koala Feature Drop 2024.1.2 Patch1，Windows 11。

核心原因：Kotlin 1.8+版本中，kotlin-stdlib已整合了kotlin-stdlib-jdk7和kotlin-stdlib-jdk8的扩展类。项目依赖了高版本kotlin-stdlib:1.8.22，但Debug变体的某个依赖引入了低版本的jdk7/jdk8专属库，导致类重复。

解决方案 #

1. 统一项目Kotlin版本 #

在项目根目录的build.gradle（或build.gradle.kts）中明确指定统一的Kotlin版本，确保所有模块和依赖对齐：

Groovy语法：

buildscript {
    ext {
        kotlin_version = "1.8.22"
    }
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

// 全局强制依赖版本（可选，确保所有Kotlin相关依赖用同一版本）
configurations.all {
    resolutionStrategy {
        force "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
        force "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
        force "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
    }
}

Kotlin DSL语法：

plugins {
    id("org.jetbrains.kotlin.android") version "1.8.22" apply false
}

// 全局强制依赖版本（可选）
configurations.all {
    resolutionStrategy {
        force("org.jetbrains.kotlin:kotlin-stdlib:1.8.22")
        force("org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.8.22")
        force("org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.8.22")
    }
}

2. 排除冲突的低版本依赖 #

找到引入低版本kotlin-stdlib-jdk7/kotlin-stdlib-jdk8的依赖（可能是第三方库或Debug专属依赖），在依赖声明中排除冲突模块：

debugImplementation("com.example:your-debug-dependency:1.0.0") {
    exclude group: "org.jetbrains.kotlin", module: "kotlin-stdlib-jdk7"
    exclude group: "org.jetbrains.kotlin", module: "kotlin-stdlib-jdk8"
}

可以通过执行gradlew.bat app:dependencies（Windows环境）查看Debug变体的依赖树，定位引入低版本库的来源。

3. 清理缓存并重新构建 #

• 执行File -> Invalidate Caches...，选择Invalidate and Restart重启Android Studio
• 删除项目根目录的.gradle文件夹和各模块下的build文件夹
• 再次执行Build -> Rebuild Project

为什么Release和直接Run无问题？ #

• Release变体通常开启了混淆（minifyEnabled true）和依赖优化，构建工具会自动移除重复类或冲突代码
• 直接执行Run -> Run App时，Android Studio采用增量构建模式，仅编译修改过的代码，未触发全量依赖冲突检查；而Rebuild Project会清理所有构建缓存，进行全量编译，严格校验所有依赖类的唯一性

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