Docker容器内Spring Boot项目热重载（Hot Swap）失效求助

针对Docker容器内Spring Boot DevTools热重载不工作的问题，可按以下步骤排查修复：

1. 强制开启Spring Boot Maven插件的Fork模式 #

DevTools的热重载依赖应用在独立进程中运行，必须在pom.xml的spring-boot-maven-plugin中显式配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <fork>true</fork> <!-- 此配置为DevTools生效的核心前提 -->
            </configuration>
        </plugin>
    </plugins>
</build>

2. 配置DevTools的文件监听与轮询机制 #

Docker挂载卷可能无法传递主机的文件系统事件（inotify），需通过配置让DevTools主动轮询文件变更，并指定监听的源码目录：
在你挂载的administration.properties中添加：

# 启用自动重启
spring.devtools.restart.enabled=true
# 指定监听的源码路径，匹配你的项目结构
spring.devtools.restart.additional-paths=/app/DLCM-Solution/src/main/java,/app/DLCM-Solution/src/main/resources
# 开启轮询模式，解决Docker文件事件传递缺失问题
spring.devtools.restart.poll-interval=2000ms
spring.devtools.restart.quiet-period=1000ms

3. 调整Docker Compose的运行配置 #

修改容器启动命令，确保Maven传递Fork参数，并通过环境变量明确启用DevTools：

dlcm-administration:
    # 保留原有其他配置
    environment:
      - SPRING_DEVTOOLS_RESTART_ENABLED=true
    command: mvn -f /app/DLCM-Solution/pom.xml spring-boot:run -Dspring-boot.run.arguments="--spring.config.location=/app/administration.properties" -Dlicense.skipCheckLicense -Dspring-boot.run.fork=true

4. 验证代码同步与编译逻辑 #

• 确认主机源码修改后，容器内/app/DLCM-Solution/src目录能实时看到变更
• 若容器内未自动编译，可在主机执行mvn compile，确保编译后的target/classes内容同步到容器（也可直接挂载主机target目录到容器对应路径，减少重复编译耗时）

5. 检查DevTools依赖加载状态 #

启动容器后，查看日志是否包含Devtools property defaults active!类输出，确认DevTools已正常加载。若未出现，可尝试移除依赖的optional=true属性测试。

内容的提问来源于stack exchange，提问作者Ricardo A.