Spring Boot DevTools无法自动检测Jar依赖变更触发重启问题求助

我之前也碰到过类似的棘手问题，Spring Boot 1.5.x版本的devtools在处理外部依赖JAR的自动重启时，确实有几个容易忽略的细节。结合你的场景，给你梳理几个排查和解决步骤：

1. 先确认依赖JAR的版本类型 #

Maven对非快照（RELEASE）版本的依赖会做本地缓存，哪怕你重新构建了依赖项目，Web应用也只会读取缓存里的旧JAR。所以必须确保：

• 依赖项目的pom.xml中，版本号是xxx-SNAPSHOT格式（比如1.0.0-SNAPSHOT）
• Web应用的依赖配置里，引用的也是这个快照版本

2. 检查DevTools的依赖和Maven插件配置 #

DevTools要正常工作，两个配置缺一不可：

（1）引入DevTools依赖

在Web应用的pom.xml中添加：

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

（2）开启Maven插件的Fork模式

DevTools需要在独立的fork进程中运行才能触发重启，所以必须在spring-boot-maven-plugin里开启fork：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <fork>true</fork> <!-- 这是核心，没开的话devtools完全不生效 -->
            </configuration>
        </plugin>
    </plugins>
</build>

3. 修正spring-devtools.properties的配置 #

你提到已经指定了JAR文件名，但可能配置项不对。对于外部依赖JAR，需要告诉DevTools监控它的生成路径：

# 监控依赖项目的target目录（每次构建后新JAR会生成在这里）
spring.devtools.restart.additional-paths=/path/to/your/dependency-project/target

# 如果只想监控这个特定JAR，排除其他无关JAR的干扰
spring.devtools.restart.exclude=**/*.jar, !your-dependency-name.jar

注意：路径要写绝对路径，或者相对于Web应用根目录的相对路径，确保DevTools能找到这个文件。

4. 命令行运行的正确姿势 #

• 启动Web应用必须用mvn spring-boot:run，而不是直接java -jar打包后的JAR，前者会加载Maven插件的fork配置，保证DevTools生效。
• 每次重构依赖项目后，记得在依赖项目根目录执行mvn install，把新的快照JAR安装到本地Maven仓库，这样Web应用才能获取到最新版本。

5. 额外排查点 #

• 查看Web应用的启动日志，有没有出现Devtools property defaults active的日志，确认DevTools已经成功启用。
• 检查有没有系统属性或环境变量禁用了重启功能，比如spring.devtools.restart.enabled=false。
• 如果还是不行，尝试清理Maven本地缓存（删除~/.m2/repository下对应依赖的目录），避免旧JAR残留。

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