Android Studio Gradle构建遇lifecycle-viewmodel依赖冲突问题

问题背景 #

维护遗留Android项目时，添加ViewModelProvider相关功能后，Android Studio自动引入了所需依赖，但构建项目时触发Duplicate class found错误，提示lifecycle-viewmodel-desktop:2.8.0与lifecycle-viewmodel-android:2.8.0存在大量重复类。执行gradlew.bat androidDependencies后确认，lifecycle-viewmodel-desktop是被间接引入的，并未手动添加该依赖。

依赖来源分析 #

lifecycle-viewmodel-desktop是Jetpack Multiplatform的组件，专为桌面平台设计，一般是某个跨平台依赖（比如Compose Multiplatform库、Kotlin Multiplatform SDK，或是兼容多平台的第三方工具库）间接带进来的。这类跨平台依赖会自动为不同平台分发对应实现，但在纯Android项目里，就会和Android专属的lifecycle-viewmodel-android产生类定义重复。

解决步骤 #

1. 定位依赖来源 #

执行命令生成完整依赖树，搜索lifecycle-viewmodel-desktop的引入路径：

# macOS/Linux
./gradlew app:dependencies --configuration releaseRuntimeClasspath | grep -A 5 -B 5 "lifecycle-viewmodel-desktop"

# Windows
gradlew.bat app:dependencies --configuration releaseRuntimeClasspath | findstr /C:"lifecycle-viewmodel-desktop" /A 5 /B 5

输出结果会显示是哪个第三方依赖间接引入了desktop版本，比如某跨平台UI库、统计SDK等。

2. 针对性排除重复依赖 #

找到来源依赖后，在模块级build.gradle（或build.gradle.kts）中给该依赖添加排除规则：

Groovy写法：

implementation('com.example:target-lib:1.0.0') {
    exclude group: 'androidx.lifecycle', module: 'lifecycle-viewmodel-desktop'
}

Kotlin DSL写法：

implementation("com.example:target-lib:1.0.0") {
    exclude(group = "androidx.lifecycle", module = "lifecycle-viewmodel-desktop")
}

3. 全局强制使用Android版本（备选） #

如果找不到具体来源，或多个依赖都引入了desktop版本，可在项目级build.gradle中添加全局强制规则，确保全项目使用Android专属的viewmodel库：

Groovy写法：

allprojects {
    configurations.all {
        resolutionStrategy {
            force 'androidx.lifecycle:lifecycle-viewmodel-android:2.8.0'
        }
    }
}

Kotlin DSL写法：

allprojects {
    configurations.all {
        resolutionStrategy.force("androidx.lifecycle:lifecycle-viewmodel-android:2.8.0")
    }
}

4. 验证修复效果 #

执行构建命令确认错误消除：

./gradlew clean build

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