如何解决构建Gradle项目时出现的AssertionError？

环境信息 #

• IDEA版本：IntelliJ IDEA 2022.1.2 (旗舰版)
• SDK：Correcto-17
• 语言级别：17

报错信息 #

Exception during working with external system: java.lang.AssertionError
at org.jetbrains.plugins.gradle.service.project.CommonGradleProjectResolverExtension.createModule(CommonGradleProjectResolverExtension.java:122)
at org.jetbrains.plugins.gradle.service.project.AbstractProjectResolverExtension.createModule(AbstractProjectResolverExtension.java:80)
at org.jetbrains.kotlin.idea.gradleJava.configuration.kpm.KotlinKPMGradleProjectResolver.createModule(KotlinKPMGradleProjectResolver.kt:46)
at org.jetbrains.plugins.gradle.service.project.AbstractProjectResolverExtension.createModule(AbstractProjectResolverExtension.java:80)
at org.jetbrains.kotlin.idea.gradleJava.configuration.KotlinMPPGradleProjectResolver.createModule(KotlinMPPGradleProjectResolver.kt:77)
at org.jetbrains.plugins.gradle.service.project.AbstractProjectResolverExtension.createModule(AbstractProjectResolverExtension.java:80)
at org.jetbrains.plugins.gradle.service.project.AbstractProjectResolverExtension.createModule(AbstractProjectResolverExtension.java:80)

解决方案 #

• 升级IDEA版本：2022.1.2版本对Kotlin多平台项目的Gradle解析存在已知兼容性问题，建议升级到2022.2及以上版本，该系列版本修复了大量Gradle模块解析相关的断言错误
• 清理缓存并重导项目：
  1. 打开IDEA，选择File -> Invalidate Caches...
  2. 勾选Clear file system cache and local history，点击Invalidate and Restart
  3. 重启后删除项目根目录下的.idea和build文件夹，重新导入Gradle项目
• 同步Kotlin插件与Gradle版本：确保IDEA的Kotlin插件版本和项目中build.gradle/build.gradle.kts里的Kotlin Gradle插件版本一致，版本不匹配会引发解析冲突
• 调整Gradle版本：若项目使用的Gradle版本过高，尝试降级到7.4.x版本，该版本与IDEA 2022.1.x兼容性较好，修改gradle/wrapper/gradle-wrapper.properties中的distributionUrl即可
• 检查KMP项目配置：如果是Kotlin多平台项目，确认settings.gradle/settings.gradle.kts中的模块声明无语法错误，错误的配置会导致Gradle解析模块时触发断言失败

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