Spring Boot 4 迁移指南
将 Lodsve Boot 应用迁移到 Spring Boot 4.1.2。
Lodsve Boot 当前只维护 Spring Boot 4 线,目标版本为 4.1.2。Spring Initializr 显示为 4.1.2.RELEASE,Maven parent 和 Gradle plugin 使用 4.1.2。
迁移清单
- 将 JDK、Maven 或 Gradle 构建环境切换到 JDK 21。
- 将
javax.servlet、javax.persistence、javax.annotation和javax.validation导入改为对应的jakarta.*包。javax.sql、javax.script属于 Java SE,无需改名。 - 删除 Springfox 和
io.swagger.annotations,使用lodsve-boot-starter-swagger提供的 Springdoc OpenAPI 3 注解,例如@Tag、@Operation、@Parameter和@Schema。 - 检查自定义自动配置。Boot 4 使用
META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports注册自动配置类。 - 重新检查 Spring Cloud、Nacos、MyBatis、Druid 和 RocketMQ 的版本组合,并执行依赖树检查。
当前兼容性说明
Lodsve Boot 4 保留 Druid 数据源连接池能力,但 Druid 1.2.28 的监控 Servlet 和 Web Filter 仍基于 javax.servlet,因此 Boot 4 自动配置不会注册 Druid 监控页面与 Web 统计过滤器。请使用 Actuator 或单独部署 Jakarta 兼容的监控组件;待 Druid 提供 Jakarta 版本后再恢复注册。
Maven 示例
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>4.1.2</version>
</parent>
使用 Lodsve Boot 时,优先将 com.lodsve.boot:lodsve-boot-dependencies 作为父 POM,由它统一管理 Starter 与第三方依赖。
验证
./mvnw clean verify
./mvnw spring-boot:run
确认应用能够启动、自动配置条件生效,并访问 Swagger UI 与 Actuator endpoint。Boot 2/3 应用不能直接复用旧的 javax.* 依赖和 Springfox 配置;请在迁移完成后再升级业务代码。
