Gradle状态转换错误求助：调试时IntelliJ重建类失败

问题场景 #

调试基于JavaExec Gradle任务的应用时，在IntelliJ中执行类重建操作，触发以下Gradle错误：

Can only transition State of build ':game-api' to state BuildFinishHooks from states [Configure, TaskSchedule, ReadyToRun] however it is currently in state ReadyToReset.

正常流程下，IntelliJ应自动重新编译变更类并完成热加载。项目简化结构如下：

• root
  • game-api（Kotlin MultiPlatform项目）
  • game-app（JVM项目，定义run任务）
  • game-engine（JVM项目，在settings.gradle.kts中引入game-api）

同结构的其他项目未出现该问题，怀疑与Kotlin多平台（KMP）配置相关，以下是具体排查方法：

排查方法 #

• 校验KMP与Gradle版本兼容性：确保game-api的Kotlin MultiPlatform插件版本与项目使用的Gradle版本匹配，参考官方兼容矩阵调整版本，避免版本不匹配导致的状态管理逻辑冲突。
• 调整IntelliJ Gradle同步策略：进入IntelliJ的Settings -> Build, Execution, Deployment -> Build Tools -> Gradle，切换Build and run using和Run tests using的选项（在Gradle和IntelliJ IDEA之间切换），重新同步项目后重试类重建操作。
• 检查模块依赖配置：验证game-engine在settings.gradle.kts中对game-api的引入是否正确，无重复引入或循环依赖；同时确认game-app的JavaExec任务是否正确声明了对game-api、game-engine编译任务的依赖，避免任务执行顺序紊乱引发状态异常。
• 清理缓存并重新导入项目：执行命令./gradlew clean build --no-build-cache清理Gradle缓存，同时删除项目根目录下的build文件夹和IntelliJ生成的.idea文件夹，重新导入项目后调试，排除缓存导致的状态不一致问题。
• 临时简化KMP目标配置：在game-api的build.gradle.kts中，临时注释掉非JVM的编译目标（如JS、Native），仅保留JVM目标配置，重新运行调试，判断是否为多目标编译流程干扰Gradle内部状态流转。
• 检查自定义任务逻辑：确认game-app的JavaExec任务是否存在自定义的依赖监听、状态修改逻辑，移除或调整这类自定义逻辑，避免干扰Gradle原生的状态转换机制。

内容的提问来源于stack exchange，提问作者Stan van der Bend