IntelliJ中Gradle HotSwap编译无关模块问题排查求助

问题背景 #

我们的Java项目采用多模块Gradle结构：

Root
+--- buildSrc
|    \--- [自定义预编译Groovy脚本插件]
+--- CoreModules
|    \--- [若干核心模块]
+--- CountryVariants
|    \--- [每个国家对应一个变体模块]
+--- GuiCountryVariants
|    \--- [特殊国家的GUI变体模块] 
\--- build.gradle (用于批量运行所有模块测试)

运行CH国家GUI变体时，其运行时依赖仅包含必要模块：

runtimeClasspath - Runtime classpath of source set 'main'.
+--- project :CoreModuleG
|    \--- project :GUICore
|         +--- project :CoreModuleB
|         |    \--- project :CoreModuleC
|         |         \--- project :CoreModuleP
|         |              \--- project :CoreModuleE
|         \--- project :GUICoreModuleG
+--- project :CountryVariantCH
|    \--- project :CoreModuleB (*)
\--- project :GUICore (*)

使用Gradle JavaExec任务启动CH变体时，仅编译所需模块，符合预期。但修改代码后执行「Run > Debugging Actions > Reload Changed Classes」时，会编译所有24个国家变体模块，而非仅当前运行的:GUICountryVariantCH:classes和:GUICountryVariantCH:testClasses任务。尝试过Single HotSwap插件，但仅支持单文件重载，无法满足多文件修改的需求。

可能原因与排查方向 #

• IntelliJ Gradle同步范围设置：默认情况下IntelliJ可能同步了所有模块，导致HotSwap触发时尝试编译所有已同步模块
• 模块依赖配置问题：检查是否存在隐式依赖，比如根build.gradle的测试任务是否强制依赖所有CountryVariants模块，或核心模块不小心依赖了所有变体
• IntelliJ社区版HotSwap机制限制：2023.2.2版本可能存在多模块Gradle项目下的HotSwap逻辑bug，无法正确识别当前运行上下文的依赖范围
• Debug配置模块范围：当前Debug运行配置可能未限定模块范围，导致IntelliJ认为需要编译所有模块

解决方案 #

• 调整Gradle同步范围：在IntelliJ的Gradle工具窗口中，点击「Toggle Offline Mode」旁的下拉菜单，将同步范围改为「Selected modules」，仅同步GUICountryVariantCH及其依赖模块
• 限定Debug配置的模块范围：打开Run/Debug Configurations，找到对应的JavaExec任务，在「Module」选项中选择「Specify modules」，仅勾选GUICountryVariantCH和其直接/间接依赖的核心模块，排除其他国家变体模块
• 清理隐式依赖：检查根build.gradle和各模块build.gradle，确保CountryVariants下的变体模块无交叉依赖，根测试任务改为按需执行（比如通过命令行参数指定测试变体）
• 升级IntelliJ版本：尝试升级到2023.3及以上社区版，新版本可能修复了多模块HotSwap的相关bug
• Gradle持续构建配合HotSwap：启动Debug会话后，在终端执行./gradlew :GUICountryVariantCH:classes --continuous，Gradle会自动编译修改的相关模块，之后手动触发HotSwap，跳过IntelliJ全量编译逻辑

成功案例参考 #

不少多模块Gradle项目开发者通过调整IntelliJ的同步范围和Debug配置，成功实现了仅编译当前运行上下文所需模块的HotSwap。明确限定模块范围后，大部分全量编译问题都能得到解决。

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