从 Spring Boot 2.x 到 3.5.x + JDK21：一次完整的生产环境迁移实战

鹰哥哥 發表於 2025-12-6 21:40:00

从 Spring Boot 2.x 到 3.5.x + JDK21：一次完整的生产环境迁移实战

<h1 id="从-spring-boot-2x-到-35x--jdk21一次完整的生产环境迁移实战">从 Spring Boot 2.x 到 3.5.x + JDK21：一次完整的生产环境迁移实战</h1>
@<div class="toc"><div class="toc-container-header">目录</div><ul><li>从 Spring Boot 2.x 到 3.5.x + JDK21：一次完整的生产环境迁移实战</li><li>升级背景</li><li>升级目标与核心变化</li><li>完整升级步骤<ul><li>第一阶段：准备工作（JDK 8 环境）<ul><li>代码分支管理</li><li>引入 OpenRewrite Maven 插件</li><li>执行自动化迁移</li><li>OpenRewrite 自动完成的变更</li><li>增量合并场景处理</li></ul></li><li>第二阶段：环境切换（JDK 21 环境）<ul><li>6. 修改 IDEA 项目配置</li></ul></li></ul></li><li>核心问题与解决方案<ul><li>问题一：Hibernate DDL Auto 的陷阱<ul><li>解决方案</li></ul></li><li>问题二：Spring Security 配置迁移</li><li>问题三：SpringDoc OpenAPI 配置</li><li>问题四：依赖冲突与安全漏洞修复</li><li>问题五：URL 尾斜杠匹配策略变更</li><li>问题六：Apache POI / EasyExcel 升级</li><li>问题七：JDK 模块化限制（--add-opens）</li><li>问题八：过期配置属性警告</li></ul></li><li>完整测试清单</li><li>升级感悟</li><li>最后：</li></ul></div>
<h1 id="升级背景">升级背景</h1>
在私有化部署过程中，客户使用安全扫描工具检测到大量安全漏洞，主要集中在： 
<ul>
<li>框架版本过低：Spring Boot 2.1.6.RELEASE（发布于 2019 年） </li>
<li>JDK 版本过旧：JDK 8（缺乏最新安全补丁） </li>
<li>第三方依赖：多个依赖存在已知 CVE 漏洞 </li>
</ul>
基于安全合规和长期维护的考虑，决定进行大版本升级。 
<ul>
<li>当前版本：Spring Boot 2.1.6.RELEASE + JDK 8 </li>
<li>目标版本：Spring Boot 3.5.4 + JDK 21 LTS</li>
</ul>
<h1 id="升级目标与核心变化">升级目标与核心变化</h1>
主要变化
<table>
<thead>
<tr>
<th style="text-align: left">类别</th>
<th style="text-align: left">变化内容</th>
<th style="text-align: left">迁移方式</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">命名空间</td>
<td style="text-align: left">javax.* → jakarta.*</td>
<td style="text-align: left">自动化迁移</td>
</tr>
<tr>
<td style="text-align: left">JDK 版本</td>
<td style="text-align: left">Java 8 → Java 21 LTS</td>
<td style="text-align: left">自动化迁移 + 手动调整</td>
</tr>
<tr>
<td style="text-align: left">第三方依赖</td>
<td style="text-align: left">大量依赖需要升级</td>
<td style="text-align: left">手动处理</td>
</tr>
<tr>
<td style="text-align: left">API 文档</td>
<td style="text-align: left">Swagger 2.x → SpringDoc OpenAPI 3.x</td>
<td style="text-align: left">配置调整</td>
</tr>
<tr>
<td style="text-align: left">安全配置</td>
<td style="text-align: left">WebSecurityConfigurerAdapter 废弃</td>
<td style="text-align: left">重写配置类</td>
</tr>
</tbody>
</table>
为什么选择自动化迁移？ 
前两项（命名空间和 JDK 版本）涉及的代码改动量极大，手动修改容易出错且效率低下。
OpenRewrite 作为业界成熟的自动化重构工具，可以完成大部分繁琐工作。
<h1 id="完整升级步骤">完整升级步骤</h1>
<h2 id="第一阶段准备工作jdk-8-环境">第一阶段：准备工作（JDK 8 环境）</h2>
<h3 id="代码分支管理">代码分支管理</h3>

<pre><code class="language-shell"># 确保主分支代码为最新
git checkout dev
git pull origin dev

# 创建升级专用分支
git checkout -b upgrade/springboot3-jdk21
</code></pre>
<h3 id="引入-openrewrite-maven-插件">引入 OpenRewrite Maven 插件</h3>

什么是 OpenRewrite？ 
OpenRewrite 是一个自动化代码重构和迁移工具，专为 Java 生态系统设计。 
核心优势： 
<ol>
<li>精确安全：在 AST（抽象语法树）层面操作，不会破坏代码结构 </li>
<li> 批量处理：一次性处理整个代码库 </li>
<li>可预览：使用 <code>rewrite:dryRun</code> 查看变更预览 </li>
<li>可定制：支持声明式（YAML）或编程式自定义规则</li>
</ol>
工作原理： 
OpenRewrite 通过解析源代码生成无损语法树（LST），在 AST 层面进行精确转换，完整保留： 
<ul>
<li>原始格式和缩进 </li>
<li>所有注释 </li>
<li>代码风格</li>
</ul>
配置方式：
在 <code>pom.xml</code> 的 <code><plugins></code> 节点下添加：
<pre><code class="language-xml"><plugin>
 <groupId>org.openrewrite.maven</groupId>
 <artifactId>rewrite-maven-plugin</artifactId>
 <version>6.15.0</version>
 <configuration>
 <exportDatatables>true</exportDatatables>
 <activeRecipes>
 
 <recipe>org.openrewrite.java.migrate.UpgradeToJava21</recipe>
 
 <recipe>org.openrewrite.java.spring.boot2.SpringBoot2JUnit4to5Migration</recipe>
 
 <recipe>org.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_4</recipe>
 </activeRecipes>
 </configuration>
 <dependencies>
 <dependency>
 <groupId>org.openrewrite.recipe</groupId>
 <artifactId>rewrite-migrate-java</artifactId>
 <version>3.14.1</version>
 <scope>runtime</scope>
 </dependency>
 <dependency>
 <groupId>org.openrewrite.recipe</groupId>
 <artifactId>rewrite-spring</artifactId>
 <version>6.11.1</version>
 </dependency>
 </dependencies>
</plugin>
</code></pre>
配方（Recipe）说明：
<ul>
<li><code>UpgradeSpringBoot_3_4 ：</code>升级至 Spring Boot 3.4.x（插件暂不支持 3.5，升级后手动修改版本号即可） </li>
<li><code>UpgradeToJava21 ：</code> 升级至 JDK 21（Spring Boot 配方仅升级到 JDK 17，需额外添加此配方） </li>
<li><code>SpringBoot2JUnit4to5Migration ：</code>升级测试框架，避免自动化测试报错</li>
</ul>
<blockquote>
提示：你也可以编写自定义配方来处理项目特定的迁移需求。
</blockquote>

<h3 id="执行自动化迁移">执行自动化迁移</h3>

<pre><code class="language-shell">mvn rewrite:run
</code></pre>
或者在 IDEA 中通过 Maven 面板执行：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959429-1550856516.png">
执行时间： 几分钟到几十分钟不等，取决于项目规模。
可能遇到的问题：
<ol>
<li>如果某些类包含特殊代码导致报错，可以先注释掉，待升级完成后再处理</li>
<li>执行完成后可以删除该插件（也可以保留，以便后续增量升级）</li>
</ol>
<h3 id="openrewrite-自动完成的变更">OpenRewrite 自动完成的变更</h3>
执行完成后，主要变化包括：
依赖升级： 
<ul>
<li><code>pom.xml</code>中的依赖版本自动升级 </li>
<li>Spring Boot 版本升级到 3.4.x（手动改为 3.5.4）</li>
</ul>
包名变更：
<ul>
<li><code>javax.servlet.* → jakarta.servlet.*</code></li>
<li><code>javax.persistence.* → jakarta.persistence.* </code></li>
<li><code>javax.validation.* → jakarta.validation.*</code></li>
</ul>
API 文档迁移：
<ul>
<li>Swagger 2.x → SpringDoc OpenAPI 3.x</li>
</ul>

JDK 新特性应用：
<ul>
<li>Text Blocks：多行字符串的优雅处理</li>
</ul>
<pre><code class="language-java">// 自动转换为
String json = """
{
"name": "user",
"age": 18
}
""";
</code></pre>
<ul>
<li>instanceof 模式匹配：简化类型判断和转换</li>
</ul>
<pre><code class="language-java">if (obj instanceof String s) {
System.out.println(s.toUpperCase());
}
</code></pre>
<ul>
<li>String.formatted()： 替代 <code>String.format()</code></li>
</ul>
<pre><code class="language-java">"Hello, %s!".formatted(name);
</code></pre>
<ul>
<li>集合增强： getFirst() 替代 get(0)</li>
<li>@Serial 注解：标记序列化相关字段</li>
</ul>

第三方库升级： 
<ul>
<li>Apache HttpClient </li>
<li>Apache Commons 系列 </li>
<li>其他常用工具库</li>
</ul>

<h3 id="增量合并场景处理">增量合并场景处理</h3>
场景： 执行 Rewrite 后，旧分支又有代码提交，合并时出现大量 <code>javax</code> 包名和 Swagger 注解冲突。
解决方案：使用 IntelliJ IDEA 自带的 Refactor 功能（本质也是基于 OpenRewrite）
操作步骤：
<ol>
<li>打开 IDEA，选择 <code>Refactor → Migrate Packages and Classes </code></li>
<li>选择迁移规则（javax → jakarta） </li>
<li>预览变更并执行</li>
</ol>
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959473-1352013624.png">
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959408-1346918808.png">
<h2 id="第二阶段环境切换jdk-21-环境">第二阶段：环境切换（JDK 21 环境）</h2>
<blockquote>
重要分界线：以下操作需在 JDK 21 环境下进行。
</blockquote>
<hr>
<h3 id="6-修改-idea-项目配置">6. 修改 IDEA 项目配置</h3>
修改 SDK 和 Language Level（快捷键：Ctrl + Alt + Shift + S）：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959474-108710220.png">
修改 Modules 的 Language Level：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959404-1882460344.png">
修改 Java Compiler（快捷键：Ctrl + Alt + S）：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959431-1051574455.png">
<hr>
<hr>
<hr>
<h1 id="核心问题与解决方案">核心问题与解决方案</h1>
<h2 id="问题一hibernate-ddl-auto-的陷阱">问题一：Hibernate DDL Auto 的陷阱</h2>
<blockquote>
严重警告：在完成以下配置前，切勿启动项目！否则可能导致数据库结构被错误修改。
</blockquote>
<hr>
问题背景
新旧版本 Hibernate 的行为差异：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959473-1968463885.png">
为什么要禁用？
在生产环境中使用 <code>spring.jpa.hibernate.ddl-auto=update</code> 存在严重风险：
<ol>
<li>数据安全风险：自动更新可能导致意外的数据丢失或结构变更 </li>
<li>性能问题：启动时全表检查会显著增加应用启动时间 </li>
<li>版本控制缺失：无法追踪数据库变更历史，不利于团队协作和回滚 </li>
<li>升级后风险更高：Hibernate 6.x 的校验更严格，误操作概率增加</li>
</ol>

<h3 id="解决方案">解决方案</h3>
方案一：配置优先级控制（推荐）
在 CI/CD 启动脚本中设置 VM 参数：
<pre><code class="language-shell">java -jar app.jar -Dspring.jpa.hibernate.ddl-auto=none
</code></pre>
优先级：VM 参数 > 配置中心（Apollo/Nacos） > application.properties
方案二：使用专业的数据库版本管理工具
推荐使用 Flyway 或 Liquibase 管理数据库脚本：
<pre><code class="language-xml"><dependency>
<groupId>org.flywaydb</groupId>
<artifactId>flyway-core</artifactId>
</dependency>
</code></pre>
方案三：结构对比工具
<ul>
<li>Navicat：提供结构同步功能 </li>
<li>DataGrip：IntelliJ 系产品，支持数据库结构对比</li>
</ul>

<h2 id="问题二spring-security-配置迁移">问题二：Spring Security 配置迁移</h2>
核心变化
<ul>
<li><code>WebSecurityConfigurerAdapter</code> 已废弃</li>
<li>推荐使用 Lambda DSL 配置方式 </li>
<li>配置方式从继承改为 Bean 注册</li>
</ul>
迁移示例
旧版配置（Spring Security 5.x）：
<pre><code class="language-java">@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
 http
 .csrf().disable()
 .sessionManagement()
 .sessionCreationPolicy(SessionCreationPolicy.STATELESS)
 .and()
 .authorizeRequests()
 .antMatchers("/api/public/**").permitAll()
 .anyRequest().authenticated();
}
}
</code></pre>
新版配置（Spring Security 6.x）：
<pre><code class="language-java">@Configuration
@EnableWebSecurity
public class SecurityConfig {
private final TokenProvider tokenProvider;
public SecurityConfig(TokenProvider tokenProvider) {
 this.tokenProvider = tokenProvider;
}
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
 http
 .csrf(AbstractHttpConfigurer::disable)
 .sessionManagement(sessionManagement -> sessionManagement
 .sessionCreationPolicy(SessionCreationPolicy.STATELESS))
 .authorizeHttpRequests(authorizeRequests -> authorizeRequests
 // 允许所有 OPTIONS 请求
 .requestMatchers(OPTIONS, "**").permitAll()
 .requestMatchers(
 "/swagger-ui/**",
 "/v3/api-docs/**",
 "/swagger-resources/**",
 "/images/**",
 "/webjars/**").permitAll()
 .anyRequest().authenticated())
 .addFilterBefore(new JWTFilter(tokenProvider), UsernamePasswordAuthenticationFilter.class);
 return http.build();
}
}
</code></pre>
RequestMatcher 调整注意事项
<ol>
<li>新增 SpringDoc 路径（必须）</li>
</ol>
<pre><code class="language-java">/swagger-ui/**

/v3/api-docs/**
</code></pre>
修正通配符写法：
<pre><code class="language-java">❌ 错误： //**/*.js
✅ 正确： /**/*.js

否则会抛出 PatternParseException

</code></pre>
<h2 id="问题三springdoc-openapi-配置">问题三：SpringDoc OpenAPI 配置</h2>
Swagger → SpringDoc 迁移
<pre><code class="language-java"> 


<dependency>
 <groupId>org.springdoc</groupId>
 <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
 <version>2.3.0</version>
</dependency>
</code></pre>
配置示例
<pre><code class="language-java">@Configuration
@OpenAPIDefinition
public class SwaggerConfig {
@Bean
public OpenAPI openAPI() {
 OpenAPI openAPI = new OpenAPI();
 openAPI.info(new Info().title("API 文档").version("1.0"));
 // 配置 Authorization 登录鉴权
 Map<String, SecurityScheme> map = Map.of("Authorization",
 new SecurityScheme()
 .type(SecurityScheme.Type.APIKEY)
 .in(SecurityScheme.In.HEADER)
 .name("Authorization"));
 openAPI.components(new Components().securitySchemes(map));
 map.keySet().forEach(key -> openAPI.addSecurityItem(new SecurityRequirement().addList(key)));
 return openAPI;
}
}
</code></pre>
注解对应关系
<table>
<thead>
<tr>
<th style="text-align: left">Swagger 2.x</th>
<th style="text-align: left">SpringDoc OpenAPI 3.x</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">@Api</td>
<td style="text-align: left">@Tag</td>
</tr>
<tr>
<td style="text-align: left">@ApiOperation</td>
<td style="text-align: left">@Operation</td>
</tr>
<tr>
<td style="text-align: left">@ApiParam</td>
<td style="text-align: left">@Parameter</td>
</tr>
<tr>
<td style="text-align: left">@ApiModel</td>
<td style="text-align: left">@Schema</td>
</tr>
<tr>
<td style="text-align: left">@ApiModelProperty</td>
<td style="text-align: left">@Schema</td>
</tr>
</tbody>
</table>
访问地址变更
原 Swagger UI 地址： <code>http://localhost:8080/swagger-ui.html </code> 
新 SpringDoc 地址： <code>http://localhost:8080/swagger-ui/index.html</code><img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959428-1456900589.png">
<h2 id="问题四依赖冲突与安全漏洞修复">问题四：依赖冲突与安全漏洞修复</h2>
检测工具
使用 IDEA 自带的依赖分析工具：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959418-636260244.png">
必须升级的依赖（存在高危漏洞） 
推荐使用 OWASP Dependency-Check 或 Snyk 扫描：
<pre><code class="language-shell">mvn dependency-check:check
</code></pre>
解决依赖冲突的技巧
问题：Maven 依赖解析采用"最短路径优先"和"第一声明优先"原则，可能导致旧版本覆盖新版本。
解决方案：显式声明期望的版本
<pre><code class="language-java"><dependencies>

<dependency>
 <groupId>org.springframework</groupId>
 <artifactId>spring-core</artifactId>
 <version>6.1.3</version>
</dependency>
</dependencies>
</code></pre>
快速检测技巧：
在 IDEA 的 Maven 依赖树中搜索 <code>RELEASE</code> ，Spring 新版本已不使用 <code>RELEASE</code> 后缀，搜索到的基本都是旧版本。
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959450-1123133955.png">
<h2 id="问题五url-尾斜杠匹配策略变更">问题五：URL 尾斜杠匹配策略变更</h2>
行为变化
<table>
<thead>
<tr>
<th style="text-align: left">版本</th>
<th style="text-align: left">行为</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">Spring Boot 2.x</td>
<td style="text-align: left">/api/user/get 和 /api/user/get/ 视为同一接口</td>
</tr>
<tr>
<td style="text-align: left">Spring Boot 3.x</td>
<td style="text-align: left">/api/user/get 和 /api/user/get/ 视为不同接口</td>
</tr>
</tbody>
</table>
常见导致尾斜杠的情况
<ul>
<li>Case 1：类注解带尾斜杠</li>
</ul>
<pre><code class="language-java">@RequestMapping("/api/user/")
public class UserController {
@PostMapping("login") // 实际路径：/api/user/login
}
</code></pre>
Case 2：空字符串映射
<pre><code class="language-java">@RequestMapping("/api/user")
public class UserController {
@PostMapping("") // 实际路径：/api/user/（带尾斜杠！）
}
</code></pre>
Case 3：根路径映射
<pre><code class="language-java">@PostMapping("/") // 实际路径：/（带尾斜杠）
</code></pre>
 
**** 检查方式 
<ol>
<li>IDEA Endpoints 工具窗口：查看所有端点 </li>
<li>SpringDoc UI：访问 Swagger 页面检查</li>
</ol>
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959437-479232744.png">
临时解决方案（不推荐长期使用）
<pre><code class="language-java">import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.PathMatchConfigurer;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfiguration implements WebMvcConfigurer {
@Override
public void configurePathMatch(PathMatchConfigurer configurer) {
 // 设置为true 以忽略尾斜杠，恢复旧版本行为
 configurer.setUseTrailingSlashMatch(true);
}
}
</code></pre>
<blockquote>
注意__： ·<code>setUseTrailingSlashMatch</code> 在 Spring 6.x 后已标记为废弃，后续版本将删除。建议逐步修正所有端点，去除尾斜杠。
</blockquote>
根本解决方案
<ol>
<li>修正所有 Controller 的路径映射 </li>
<li>通知前端团队同步修改调用路径 </li>
<li>如果有硬编码的 URL，全局搜索并修正 </li>
<li>使用测试确保前后端调用正常</li>
</ol>

<h2 id="问题六apache-poi--easyexcel-升级">问题六：Apache POI / EasyExcel 升级</h2>
背景 
Apache POI 旧版本（< 5.0）存在多个 CVE 安全漏洞，必须升级。
推荐方案
对于新项目：直接使用 FastExcel
<pre><code class="language-java"><dependency>
<groupId>cn.idev.excel</groupId>
<artifactId>fastexcel</artifactId>
<version>1.0.0</version>
</dependency>
</code></pre>
对于使用 EasyExcel 的旧项目：
<pre><code class="language-java"><dependency>
<groupId>com.alibaba</groupId>
<artifactId>easyexcel</artifactId>
<version>4.0.3</version>
</dependency>
</code></pre>
<blockquote>
说明：EasyExcel 已不再维护，FastExcel 是社区维护的替代方案，API 基本兼容。
</blockquote>
迁移注意事项
EasyExcel 跨大版本升级（2.x → 4.x）API 变化较大，主要改动： 
1. 监听器接口方法签名调整 
2. 部分工具类包路径变更 
3. 自定义转换器需要适配新接口 
建议参考官方迁移文档：EasyExcel官方文档 - 基于Java的Excel处理工具 | Easy Excel 官网

<h2 id="问题七jdk-模块化限制--add-opens">问题七：JDK 模块化限制（--add-opens）</h2>
问题现象 
某些依赖库使用反射访问 JDK 内部 API，在 JDK 9+ 模块化系统下会报错：
<pre><code class="language-java">InaccessibleObjectException: Unable to make field accessible:
module java.base does not "opens java.net" to unnamed module
</code></pre>
解决方案 
在 IDEA 运行配置中添加 VM 参数： 
开启 VM 参数配置（默认隐藏）：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959454-2062859529.png">
解决方案 
在 IDEA 运行配置中添加 VM 参数： 
开启 VM 参数配置（默认隐藏）：
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959969-765078803.png">
常见需要开放的模块
<pre><code class="language-java">--add-opens java.base/java.lang=ALL-UNNAMED
--add-opens java.base/java.util=ALL-UNNAMED
--add-opens java.base/java.lang.reflect=ALL-UNNAMED
--add-opens java.base/sun.nio.ch=ALL-UNNAMED
</code></pre>


<h2 id="问题八过期配置属性警告">问题八：过期配置属性警告</h2>
问题现象
启动时出现警告：
<pre><code class="language-java">Property 'spring.xxx.yyy' is deprecated
</code></pre>
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959419-1910101826.png">
解决方案：
<ol>
<li>
查看 Spring Boot 官方迁移文档
</li>
<li>
使用 IDEA 的智能提示查看替代属性
</li>
<li>
修改配置文件（常见过期属性：<code>application.yml</code> 或配置中心)
</li>
</ol>
常见过期属性：
<table>
<thead>
<tr>
<th style="text-align: left">过期属性</th>
<th style="text-align: left">替代属性</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left">spring.datasource.type</td>
<td style="text-align: left">自动推断，无需配置</td>
</tr>
<tr>
<td style="text-align: left">spring.jpa.properties.hibernate.temp.use_jdbc_metadata_defaults</td>
<td style="text-align: left">已移除</td>
</tr>
<tr>
<td style="text-align: left">management.metrics.export.prometheus.enabled</td>
<td style="text-align: left">management.prometheus.metrics.export.enabled</td>
</tr>
</tbody>
</table>

 
<h1 id="完整测试清单">完整测试清单</h1>
升级完成后，务必进行全面的回归测试： 
<ul>
<li>Spring Security：认证、授权是否正常 </li>
<li>SpringDoc：API 文档是否可访问（ /swagger-ui/index.html ） </li>
<li>数据库操作：JPA/MyBatis 是否正常工作 </li>
<li>缓存：Redis/Caffeine 等缓存是否生效 </li>
<li>消息队列：RabbitMQ/Kafka 等是否正常 </li>
<li>定时任务：Scheduled/Quartz 是否按预期执行 </li>
<li>文件上传/下载：文件 IO 操作是否正常 </li>
<li>业务功能：核心业务流程是否正常（重点关注有代码改动的地方） </li>
<li>性能测试：对比升级前后的性能指标</li>
</ul>

<h1 id="升级感悟">升级感悟</h1>
框架层面的变化趋势 
通过这次升级，我观察到现代框架的一些发展趋势： 
<ol>
<li>校验更严格：</li>
</ol>
<ul>
<li>Spring 不再容忍 URL 尾斜杠的模糊匹配 </li>
<li>循环依赖检测更严格（默认禁止） </li>
<li>Hibernate 对实体状态的校验更精确</li>
</ul>
<ol start="2">
<li>安全性优先： </li>
</ol>
<ul>
<li>默认配置更保守 </li>
<li>废弃不安全的 API </li>
<li>强制升级修复已知漏洞</li>
</ul>
<ol start="3">
<li>现代化 API： </li>
</ol>
<ul>
<li>Lambda DSL 配置风格 </li>
<li>函数式编程支持 </li>
<li>更简洁的 API 设计</li>
</ul>

依赖选择建议 
基于这次升级经验，对于第三方库的选择建议： 
优先选择： 
✅ 国际主流项目（Apache、Spring 生态等） 
✅ 有完善文档和测试的项目 
✅ 活跃维护且社区规模大的项目 
✅ 语义化版本管理清晰的项目 
谨慎选择： 
⚠️ 缺乏自动化测试的项目 
⚠️ 长期未更新的项目 
⚠️ API 设计不稳定、频繁 Breaking Change 的项目 
⚠️ 文档不全、维护团队不稳定的项目

自动化迁移的价值 
OpenRewrite 等自动化工具在大版本升级中的价值无可替代： 
<ul>
<li>减少 90% 以上的机械性改动 </li>
<li>避免手工替换导致的遗漏 </li>
<li>保持代码风格和注释 </li>
<li>降低升级风险 </li>
</ul>
建议在日常开发中也关注此类工具，提升团队整体效率。


本文首发于 [尚硅谷编程联盟]，转载请注明出处。
<h1 id="最后">最后：</h1>
<blockquote>
“在这个最后的篇章中，我要表达我对每一位读者的感激之情。你们的关注和回复是我创作的动力源泉，我从你们身上吸取了无尽的灵感与勇气。我会将你们的鼓励留在心底，继续在其他的领域奋斗。感谢你们，我们总会在某个时刻再次相遇。”
<img src="https://img2024.cnblogs.com/blog/3084824/202512/3084824-20251206213959471-1115105071.gif">
</blockquote> 
来源：https://www.cnblogs.com/TheMagicalRainbowSea/p/19316680

頁: [1]

琼殿技术论坛's Archiver

从 Spring Boot 2.x 到 3.5.x + JDK21：一次完整的生产环境迁移实战