IDEA通过SSH运行多模块SpringBoot时dev-tools不生效如何解决

问题复现 #

相同SSH远程运行配置下，两类项目表现不一致：

• 单SpringBoot项目：修改Java文件后DevTools可正常触发热更新
  
• 多模块SpringBoot项目：DevTools热部署完全不触发
  

核心原因&对应修复方案 #

问题和SSH运行配置本身无关，本质是多模块项目的类路径、依赖、配置、IDEA模块绑定逻辑和单模块存在差异，逐一排查以下4个点即可解决：

• 编译输出路径未被DevTools监控
  单模块项目编译输出统一落在当前模块的target/classes目录，DevTools默认监控该路径即可捕捉变更；多模块项目修改非启动类的公共子模块（如common、util包）时，IDEA默认仅编译改动的子模块，不会将变更class同步到启动模块的类路径，远程DevTools自然无法感知改动。
  修复操作：

  • 打开IDEA设置 Build, Execution, Deployment > Compiler，勾选Build project automatically
  • 双击Shift搜索Registry进入配置页，勾选compiler.automake.allow.when.app.running
  • 打开SSH运行配置，在Before launch栏新增Build Project步骤，不要仅选择编译单个模块，确保所有子模块改动都能同步到类路径

• DevTools依赖配置错误
  多模块项目通常在父POM做依赖管理，很容易出现启动模块未显式引入DevTools、依赖scope配置错误、依赖被排除的情况，导致DevTools远程监听组件根本没有加载到进程中。
  修复操作：

  • 父POM中统一管理DevTools版本，不要额外配置scope
  • 实际通过SSH启动的业务子模块（带@SpringBootApplication启动类的模块）必须显式引入依赖，保持默认scope即可：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>

• DevTools监控范围&连接配置未覆盖多模块
  单模块项目配置文件直接放在启动模块的resource目录可直接生效，多模块项目如果配置放在公共子模块被启动模块配置覆盖、或者未将其他子模块的编译路径加入监控列表，会导致DevTools远程监听端口未开启、非启动模块的变更不在监控范围内。
  修复操作：
  在启动模块的application.yml中增加以下配置：

spring:
  devtools:
    remote:
      secret: custom-devtools-secret # 自定义远程连接密钥
      restart:
        enabled: true
    restart:
      enabled: true
      # 将所有依赖的子模块编译输出路径加入监控列表
      additional-paths: ../common-module/target/classes,../util-module/target/classes

SSH启动远程进程时，确保JVM参数中携带密钥配置：

-Dspring.devtools.remote.secret=custom-devtools-secret

• IDEA运行配置绑定模块错误
  单模块项目IDEA会自动绑定唯一的业务模块，多模块项目如果SSH运行配置的Use classpath of module选项选的是根目录的POM类型父模块，而非实际启动的业务子模块，IDEA不会在代码改动后向远程进程发送重启触发信号。
  修复操作：打开SSH运行配置，将Use classpath of module下拉选项切换为实际启动的业务子模块即可。

验证方式 #

配置完成后修改任意子模块的Java文件，等待IDEA自动编译完成后，查看远程进程日志，如果出现Restarting due to class path change相关日志，即代表热部署恢复正常。

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