如何彻底禁用 Spring Boot 的热部署功能？| 小白也能懂的解决方案

原创于 2025-05-20 10:27:56 发布 · 740 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#java

Java 同时被 3 个专栏收录

120 篇文章

订阅专栏

SpringBoot

65 篇文章

订阅专栏

数据库

9 篇文章

订阅专栏

什么是 Spring Boot 热部署？

如果你正在学习或使用 Spring Boot 框架，可能会遇到一个叫做 spring-boot-devtools 的依赖。它的作用是让开发者更高效地调试代码，主要提供以下功能：

自动重启（热部署）：当你修改 Java 代码后，应用会自动重启，无需手动停止再启动。
（例如：修改了 Controller 的代码，刷新浏览器就能看到变化）
静态资源实时更新：修改 HTML、CSS、JS 等文件后，浏览器会自动刷新页面。
（适合前端调试）
开发者友好配置：默认关闭模板引擎的缓存（如 Thymeleaf），方便调试时实时看到修改效果。

为什么要禁用热部署？

虽然热部署听起来很方便，但有些场景下你可能需要关闭它：

项目已进入稳定阶段：不需要频繁调试代码，自动重启反而可能干扰正常流程。
资源占用敏感：热部署会额外占用内存和 CPU 资源。
与其他工具冲突：某些 IDE 或插件可能与 devtools 不兼容，导致奇怪的问题。

如何彻底禁用热部署？

错误理解：`<optional>true</optional>` 能禁用热部署吗？

不能！
<optional>true</optional> 仅表示该依赖不会传递到其他项目中（比如你的项目被别人作为库依赖时，别人不会继承 devtools）。
但当前项目中，热部署功能依然有效！

正确做法：直接移除或注释依赖

在项目的 pom.xml 文件中，找到以下依赖，直接删除或注释掉：

<!-- 注释或删除以下内容即可彻底禁用热部署 -->
<!--
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>
-->

操作后效果：

应用不再自动重启。
修改静态资源后需手动刷新浏览器。
模板引擎缓存恢复默认行为（需手动清理缓存）。

其他常见问题

1. 临时关闭热部署可以吗？

通过配置文件 application.properties 可以临时关闭自动重启，但不推荐（依赖依然存在，可能引发其他问题）：

# application.properties
spring.devtools.restart.enabled=false

2. 移除了依赖，为什么代码还是自动重启了？

可能是 IDE 自带的热部署功能（如 IntelliJ IDEA 的 Build -> Compile 自动编译）。需在 IDE 设置中关闭相关选项。

3. 团队开发中需要统一配置吗？

是的！如果团队中有人保留 devtools 而有人移除，可能导致环境不一致。建议在项目初始化时明确是否需要热部署。

总结

场景	操作	效果
需要热部署	保留 `devtools` 依赖	自动重启、实时刷新
彻底禁用热部署	移除 `devtools` 依赖	完全关闭所有相关功能
临时关闭自动重启	配置 `spring.devtools.restart.enabled=false`	保留其他功能（不推荐）