Kotlin多模块build.gradle.kts依赖解析类型异常问题排查

是否导致依赖解析失败？ #

这种语法高亮异常和类型推断偏差不一定立刻触发依赖解析失败，但本质是Gradle脚本的上下文识别出了问题。如果getting语法无法被Gradle正确解析，后续同步或编译时大概率会出现依赖无法识别、同步失败或者编译报错的情况。

解决方法 #

• 确认模块插件配置正确
  确保有问题的模块已正确应用对应Kotlin插件（比如多平台项目的kotlin("multiplatform")，JVM项目的kotlin("jvm")）。插件是让Gradle识别commonMain这类源集依赖块为KotlinDependencyHandler的核心，未正确应用会 fallback 到通用的DependencyHandlerScope。示例配置：

  plugins {
      kotlin("multiplatform") version "1.9.20" // 替换为你的项目实际版本
  }
  

• 强制刷新Gradle依赖
  执行终端命令./gradlew clean build --refresh-dependencies，或者在IDE中点击Refresh Gradle Dependencies按钮，强制Gradle重新加载脚本和依赖缓存，排除缓存导致的解析异常。

• 检查源集配置语法
  排查commonMain代码块前后是否存在语法错误（比如遗漏大括号、逗号错位），这类错误会导致Gradle解析脚本时上下文错乱，进而影响类型推断。

• 统一Gradle与Kotlin版本
  确保项目根目录的Gradle版本和模块使用的Kotlin版本兼容，比如根目录gradle.properties中的kotlin.version与模块插件声明的版本保持一致，版本不兼容易引发插件API解析异常。

• 清除IDE缓存
  如果是IDE（IntelliJ/Android Studio）的语法高亮问题，执行File -> Invalidate Caches... -> Invalidate and Restart，解决IDE静态解析与Gradle实际解析不同步的问题。

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