模块重构后编译失败：-Xuse-experimental标志兼容问题排查

一、编译器不支持-Xuse-experimental=kotlin.Experimental及模块加载失败问题 #

• 适配Kotlin新版本规则：-Xuse-experimental=kotlin.Experimental是Kotlin 1.3以前的旧参数，1.3+版本已弃用。直接在代码中使用@OptIn(kotlin.Experimental::class)标注需要启用实验性API的类/方法，同时从Gradle配置中移除该参数。
• 全局同步Gradle配置：多模块项目中，确保配置覆盖所有模块。在根目录build.gradle添加全局配置：

  subprojects {
      tasks.withType(org.jetbrains.kotlin.gradle.tasks.KotlinCompile).all {
          kotlinOptions.freeCompilerArgs += ['-Xjvm-default=all-compatibility']
      }
  }
  

• 清理缓存重建：执行./gradlew clean build --refresh-dependencies清除旧缓存，重新同步Gradle项目，确保配置生效。

二、定位:app:kaptGenerateStubsMyIapKotlin任务排查问题 #

• 查看详细执行日志：运行命令获取任务执行的完整流程和报错细节：

  ./gradlew :app:kaptGenerateStubsMyIapKotlin --info
  

• 检查任务输入输出：通过命令确认任务处理的文件路径，排查重构后是否存在路径错误或文件缺失：

  ./gradlew :app:kaptGenerateStubsMyIapKotlin --inputs --outputs
  

• IDE面板直接操作：打开Android Studio右侧Gradle面板，展开app→kapt分组，找到目标任务，右键选择Run或Debug，在IDE中实时查看执行状态和报错位置。
• 关联错误栈信息：任务失败时，直接提取控制台输出的错误栈，定位到具体的类、注解或依赖问题（比如kapt注解处理器是否因模块重构丢失依赖）。

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