KMM项目构建报错：':shared'模块未找到'testClasses'任务

一、':testClasses'任务的作用 #

testClasses是Gradle Java插件提供的标准任务，核心作用是编译项目中所有测试代码，并将生成的字节码整理到指定目录，供后续测试执行或依赖使用。但这个任务是针对单平台JVM项目设计的，在KMM跨平台模块中默认不会生成全局的testClasses任务。

二、问题原因 #

你的KMM shared模块是多平台项目，Gradle会为每个目标平台生成独立的测试相关任务（比如androidTestClasses、commonTestClasses），但不会提供全局的testClasses任务。构建流程中触发了:shared:testClasses，导致Gradle找不到对应任务而报错。

这种情况常见于Android Studio新版本（如Iguana）的默认构建配置、插件冲突，或是误将单平台任务加入了跨平台项目的构建流程。

三、解决办法 #

1. 替换为平台特定的测试任务 #

将构建任务中的:shared:testClasses替换为对应平台的测试类任务：

• 处理通用测试代码：使用:shared:commonTestClasses
• 处理Android测试代码：使用:shared:androidTestClasses
• 处理iOS测试代码：使用对应架构的任务（如:shared:iosSimulatorArm64TestClasses）

2. 清理IDE缓存并同步Gradle #

1. 打开Android Studio，点击File -> Invalidate Caches...
2. 勾选Clear file system cache and local history，点击Invalidate and Restart
3. 重启后重新同步Gradle项目

3. 手动注册全局testClasses任务（不推荐） #

如果确实需要全局的testClasses任务，可以在shared模块的build.gradle.kts中手动注册：

tasks.register("testClasses") {
    dependsOn(tasks.withType<org.gradle.api.tasks.testing.Test>())
}

注：此方式可能导致跨平台测试任务的执行逻辑混乱，优先推荐使用平台特定任务。

4. 检查插件版本兼容性 #

确保kotlinMultiplatform插件与Gradle版本匹配，建议使用Kotlin官方稳定版插件，避免版本不匹配导致的任务缺失问题。

四、是否有其他人遇到相同问题？ #

是的，这个问题是KMM新手在Android Studio新版本中常见的构建问题，不少开发者在社区反馈过类似情况，大多是由于IDE默认构建任务与KMM跨平台项目的任务体系不兼容导致。

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