Spring Boot在Docker容器中DevTools热重载生效但变更未生效问题

我来帮你搞定这个Spring DevTools在Docker容器里热重载触发了但代码变更不生效的问题，咱们先把问题根源拆清楚，再一步步解决：

问题根源分析 #

你的情况其实是两个因素叠加导致的：

1. DevTools配置限制了Java文件的监听：你设置了spring.devtools.restart.additional-exclude=src/main/java/**，这意味着DevTools不会主动监听src/main/java下的Java文件变更——你只能通过修改reload-trigger.txt手动触发重启，但此时Gradle并没有自动重新编译修改后的源文件，JVM加载的还是旧的class文件，所以重载后代码没变化。
2. Gradle bootRun默认不自动编译：Docker容器里运行的gradle bootRun任务，默认只在启动时编译一次代码，后续源文件变化不会自动触发重新编译——这就是为什么重启容器后变更会生效（重启时重新执行了编译流程）。

具体解决方案 #

方案1：自动监听+自动编译（推荐） #

这个方案让Gradle自动编译变更，DevTools自动感知并重启，完全不需要手动触发：

1. 调整Spring DevTools配置：
   移除spring.devtools.restart.additional-exclude=src/main/java/**（如果不需要手动触发的话），让DevTools监听Java文件的变化：

   spring.devtools.restart.enabled=true
   spring.devtools.restart.additional-paths=.
   

   如果你还是想保留手动触发的方式，也可以保留additional-exclude，但后续需要结合Gradle的持续构建来确保编译。

2. 修改Dockerfile的启动命令：
   在bootRun后添加--continuous参数，启用Gradle的持续构建模式，让它持续监听源文件变化并自动编译：

   FROM gradle:5.6.2-jdk8
   WORKDIR /app
   COPY . /app
   RUN ./gradlew getDeps
   EXPOSE 8000
   CMD ["gradle", "bootRun", "-PskipDownload=true", "--continuous"]
   

   这样一来，你修改Volume里的Java文件后，Gradle会自动编译，DevTools感知到class文件变化就会重启应用，直接访问接口就能看到变更生效。

方案2：保留手动触发，强制编译后重启 #

如果你坚持要用reload-trigger.txt手动触发重载，可以这样配置：

1. 明确DevTools的触发文件：
   在配置中添加trigger-file指定触发文件，确保DevTools只会在你修改这个文件时重启：

   spring.devtools.restart.enabled=true
   spring.devtools.restart.additional-paths=.
   spring.devtools.restart.additional-exclude=src/main/java/**
   spring.devtools.restart.trigger-file=src/main/resources/reload-trigger.txt
   

2. 让Gradle在重启前先编译：
   在项目的build.gradle中添加一个自定义任务，先编译再启动应用：

   task bootRunWithCompile(type: GradleBuild) {
       tasks = ['compileJava', 'bootRun']
   }
   

   然后修改Dockerfile的CMD命令，启用持续构建：

   CMD ["gradle", "bootRunWithCompile", "-PskipDownload=true", "--continuous"]
   

   现在每次你修改reload-trigger.txt，Gradle都会先重新编译Java文件，再让DevTools重启应用，变更就能生效了。

额外检查点 #

• 确认Volume挂载正确：运行容器时要确保本地项目目录完全挂载到容器的/app目录，比如：

  docker run -v $(pwd):/app -p 8000:8000 your-image-tag
  

• 清除Gradle缓存：如果还是有问题，可以在启动命令中添加--no-build-cache，避免Gradle使用旧的编译缓存：

  CMD ["gradle", "bootRun", "-PskipDownload=true", "--continuous", "--no-build-cache"]
  

验证步骤 #

1. 修改Volume中的Controller文件；
2. 方案1：等待3-5秒，Gradle自动编译，DevTools自动重启；方案2：修改reload-trigger.txt触发编译和重启；
3. 直接在Postman中访问接口，变更应该已经生效，不需要重启容器。

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