Spring Boot DevTools 无法正常工作？仅主Java文件生效问题排查

以下是针对该问题的排查和解决步骤：

1. 确认DevTools依赖与构建插件配置 #

DevTools需要应用在独立进程中运行，确保依赖和构建插件配置正确：

Maven 配置 #

在pom.xml中添加DevTools依赖，并开启Spring Boot插件的fork模式：

<!-- DevTools 依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

<!-- Spring Boot 构建插件 -->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <!-- 必须开启fork，否则DevTools无法正常工作 -->
                <fork>true</fork>
            </configuration>
        </plugin>
    </plugins>
</build>

Gradle 配置 #

在build.gradle中添加DevTools依赖（Gradle默认已开启fork）：

// DevTools 依赖
developmentOnly 'org.springframework.boot:spring-boot-devtools'

2. 验证IDE自动构建的完整配置 #

IntelliJ IDEA #

• 开启自动构建：Settings → Build, Execution, Deployment → Compiler，勾选Build project automatically
• 允许运行时自动构建：Settings → Advanced Settings → Compiler，勾选Allow auto-make to start even if developed application is currently running
• 关闭Power Save模式（若开启）：点击右下角状态栏电池图标，取消Power Save启用状态

VS Code #

• 确保安装Spring Boot Extension Pack插件
• 在settings.json中添加以下配置：

{
    "java.autobuild.enabled": true,
    "spring-boot.devtools.restart.enabled": true,
    "spring-boot.live-reload.enabled": true
}

• 通过Spring Boot Dashboard启动应用，而非普通Java运行方式

3. 检查DevTools重启范围配置 #

确认application.properties或application.yml中没有错误排除业务类路径，必要时显式指定监听范围：

# 显式指定需要监听的业务类包路径（替换为你的实际包路径）
spring.devtools.restart.include=com/yourproject/**/*
# 排除无需监听的静态资源路径
spring.devtools.restart.exclude=static/**,public/**

若项目有自定义目录结构，可添加额外监听路径：

spring.devtools.restart.additional-paths=src/main/java,src/main/resources

4. 排查类加载器问题 #

DevTools通过重启类加载器加载业务类，若业务类被基础类加载器加载则无法触发热重载：

• 不要将业务类放在src/main/resources目录下
• 避免在第三方依赖中打包自身业务类（确保业务类仅位于当前项目的src/main/java下）
• 若存在自定义类加载逻辑，确保不干扰DevTools的类加载机制

5. 测试与验证 #

修改任意业务类代码（比如添加一行日志），观察IDE的Build控制台：

• 若构建未触发：手动执行一次构建（IntelliJ按Ctrl+F9，VS Code按Ctrl+Shift+B），再检查自动构建配置
• 若构建完成但应用未重启：重新核对DevTools的范围配置和fork设置

内容的提问来源于stack exchange，提问作者Ramalingamn.N