Android测试出现ViewModelLazy重复类依赖冲突问题求助

核心原因 #

1. 测试依赖的传递性引入：即使你没显式在shared/logger模块添加lifecycle依赖，Android测试框架（AGP会自动引入基础测试依赖）或JUnit相关依赖会传递引入不同版本的lifecycle-viewmodel库，导致测试编译类路径中出现重复类。
2. 版本约束冲突：部分第三方依赖或AGP旧版本会硬绑定特定版本的lifecycle库（比如2.2.0），强制指定新版本时会触发debugRuntimeClasspath的版本约束冲突。

解决步骤 #

1. 定位重复依赖的来源 #

先执行命令排查shared模块androidTest配置下的依赖树，找到引入lifecycle库的具体依赖：

./gradlew shared:dependencies --configuration androidTestCompileClasspath

在输出中搜索androidx.lifecycle:lifecycle-viewmodel，查看哪些依赖传递引入了它，以及对应的版本号。

2. 统一lifecycle版本（推荐方案） #

通过项目级的版本约束，强制所有模块使用同一版本的lifecycle库：

• 在项目根目录的settings.gradle中添加版本目录配置（适用于AGP 7.0+）：

  dependencyResolutionManagement {
      versionCatalogs {
          libs {
              version('lifecycle', '2.6.2') // 选择一个稳定的最新版本
              library('lifecycle-viewmodel', 'androidx.lifecycle', 'lifecycle-viewmodel').versionRef('lifecycle')
              library('lifecycle-viewmodel-ktx', 'androidx.lifecycle', 'lifecycle-viewmodel-ktx').versionRef('lifecycle')
          }
      }
  }
  

• 或者在根目录build.gradle中添加全局强制版本：

  allprojects {
      configurations.all {
          resolutionStrategy {
              force 'androidx.lifecycle:lifecycle-viewmodel:2.6.2'
              force 'androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2'
          }
      }
  }
  

3. 排除测试依赖中的冗余lifecycle引入 #

如果某测试依赖（如androidx.test.ext:junit）传递引入了旧版本lifecycle，在shared模块的build.gradle中排除该依赖：

androidTestImplementation 'androidx.test.ext:junit:1.1.5' {
    exclude group: 'androidx.lifecycle', module: 'lifecycle-viewmodel'
    exclude group: 'androidx.lifecycle', module: 'lifecycle-viewmodel-ktx'
}

4. 处理debugRuntimeClasspath版本冲突 #

执行命令定位强制2.2.0版本的依赖来源：

./gradlew shared:dependencies --configuration debugRuntimeClasspath

找到硬绑定2.2.0版本的依赖后，在该依赖中排除lifecycle模块，或者在对应配置中强制覆盖版本：

configurations.debugRuntimeClasspath {
    resolutionStrategy {
        force 'androidx.lifecycle:lifecycle-viewmodel:2.6.2'
    }
}

5. 升级AGP版本 #

如果使用的是较旧的Android Gradle Plugin，升级到最新稳定版（如8.0+），旧版本AGP默认引入的lifecycle版本较老，更容易引发版本冲突。

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