Spring Boot 3无缝迁移到Spring Boot 4实战完整代码对比(轻松升级!)

# 1. 确保当前项目在 Spring Boot 3 下正常运行
mvn -DskipTests package

# 2. 启动应用，验证核心功能
java -jar target/your-app.jar --spring.profiles.active=dev

# 3. 验证关键接口
# - 登录接口
# - 用户信息接口
# - 菜单路由接口
# - 接口文档页面

# 创建专门的升级分支
git checkout -b chore/upgrade-springboot4

# 记录当前版本信息（非常重要！）
cat pom.xml | grep -A2 -B2 "spring-boot-starter-parent"

<!-- 升级前 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.5.6</version>
</parent>

<!-- 升级后 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>4.0.1</version>
</parent>

<!-- 升级前 -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
    <version>3.5.5</version>
</dependency>

<!-- 升级后：注意 starter 名称变化！ -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot4-starter</artifactId>
    <version>3.5.15</version>  <!-- 版本也需要同步升级 -->
</dependency>

<!-- 升级前 -->
<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>3.51.0</version>
</dependency>

<!-- 升级后 -->
<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>4.1.0</version>
</dependency>

<!-- 升级前 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aop</artifactId>
</dependency>

<!-- 升级后（如果你的项目使用AOP） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-aspectj</artifactId>
</dependency>

import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import tools.jackson.databind.JsonMapper;
import tools.jackson.databind.module.SimpleModule;

import java.math.BigInteger;
import java.text.SimpleDateFormat;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.TimeZone;

@Configuration
public class JacksonConfig {

    @Bean
    public JsonMapper jsonMapper() {
        return JsonMapper.builder()
                // 设置日期格式
                .defaultDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"))
                // 设置时区（中国标准时间）
                .defaultTimeZone(TimeZone.getTimeZone("GMT+8"))
                // 处理 Long 类型精度丢失问题
                .addModule(new SimpleModule()
                        .addSerializer(Long.class, ToStringSerializer.instance)
                        .addSerializer(Long.TYPE, ToStringSerializer.instance)
                        .addSerializer(BigInteger.class, ToStringSerializer.instance))
                // LocalDateTime 序列化
                .addModule(new SimpleModule()
                        .addSerializer(LocalDateTime.class,
                            new LocalDateTimeSerializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"))))
                .build();
    }
}

// ❌ 错误的做法（在 Spring Boot 4 中会导致问题）
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // 不要在这里移除或替换 converters！
        // 这会破坏 ByteArrayHttpMessageConverter
    }
}

// ✅ 正确的做法：删除这个配置类
// 或者只保留不涉及 converters 的配置
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    // 只配置拦截器、跨域等，不碰 converters
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        // 跨域配置
    }
}

// Spring Boot 3
import org.springframework.boot.autoconfigure.cache.CacheProperties;

// Spring Boot 4
import org.springframework.boot.cache.autoconfigure.CacheProperties;

Expected 2 arguments but found 1

// Spring Boot 3
ContentCachingRequestWrapper requestWrapper = new ContentCachingRequestWrapper(request);

// Spring Boot 4
ContentCachingRequestWrapper requestWrapper = new ContentCachingRequestWrapper(request, -1);

constructor AbstractAuthenticationToken in class AbstractAuthenticationToken cannot be applied to given types

// Spring Boot 3（旧写法）
super(null);
// Spring Boot 4（新写法）
super((Collection<? extends GrantedAuthority>) null);

# 问题现象
curl http://localhost:8000/v3/api-docs/default

# 返回结果（异常）：
"eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"

# 正常应该返回：
{
  "openapi": "3.0.1",
  "info": {
    "title": "API文档",
    "version": "v1.0"
  },
  // ... 其他JSON内容
}

server:
  port: 8000
  servlet:
    context-path: /

spring:
  application:
    name: youlai-boot
  profiles:
    active: @profiles.active@  # 确保这个配置正确

  # 数据库配置（保持不变）
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/youlai?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    username: root
    password: 123456

springdoc:
  api-docs:
    path: /v3/api-docs # 确认路径正确
    enabled: true
  swagger-ui:
    path: /swagger-ui.html # Swagger UI路径
    enabled: true
  group-configs:
    - group: "default"
      paths-to-match: "/api/**"
      packages-to-scan: com.youlai.**.controller

security:
  unsecured-urls:
    - /doc.html # Knife4j文档页
    - /v3/api-docs/** # OpenAPI JSON
    - /swagger-ui/** # Swagger UI
    - /webjars/** # 静态资源
    - /favicon.ico
    # ... 其他业务白名单

1. 备份当前项目 ✅
2. 创建升级分支 ✅
3. 升级 parent 版本 ✅
4. 逐个升级关键依赖 ✅
5. 适配代码（JacksonConfig）✅
6. 移除有问题配置 ✅
7. 编译测试 ✅
8. 启动验证 ✅
9. 功能回归测试 ✅
10. 合并到主分支 ✅