Spring Boot 4 升级踩坑实录

J 小助 · 发表于 7 小时前

JeecgBoot 从 Spring Boot 3.5.5 升级到 4.1.0 (Spring Framework 7.x) 的兼容性修复记录

升级概述

项目	旧版本	新版本
Spring Boot	3.5.5	4.1.0
Spring Framework	6.x	7.x
Java	17	17

编译期修复

1. 实体字段名不匹配导致 getter 不存在

文件: OpenApiController.java

openApi.getBody() → openApi.getRequestBody()

原因: 实体 OpenApi 字段名为 requestBody，Lombok 生成的是 getRequestBody()，原来写错了方法名。

2. HttpHeaders 改为 final 类，禁止匿名子类

文件: Response.java

// ❌ Spring Framework 7: HttpHeaders 是 final
new HttpHeaders() { { put("Content-Type", contentType); } };

// ✅ 标准写法
HttpHeaders headers = new HttpHeaders();
headers.put("Content-Type", contentType);

3. ResponseEntity.getStatusCodeValue() 已移除

文件: HttpNode.java

responseEntity.getStatusCodeValue() → responseEntity.getStatusCode().value()

4. MediaType.APPLICATION_JSON_UTF8_VALUE 已移除

文件: 多个文件

MediaType.APPLICATION_JSON_UTF8_VALUE → MediaType.APPLICATION_JSON_VALUE

原因: Spring 5.3+ JSON 默认就是 UTF-8 (RFC 8259)。

5. HttpHeaders.containsKey() 已移除

文件: HttpNode.java, ToolsNode.java

// ❌
headers.containsKey(HttpHeaders.CONTENT_LENGTH)
headers.containsKey(HttpHeaders.CONTENT_TYPE)

// ✅
headers.getContentLength() == -1
headers.getContentType() == null

6. HttpComponentsClientHttpRequestFactory 超时方法已移除

文件: HttpNode.java

HttpComponentsClientHttpRequestFactory → SimpleClientHttpRequestFactory

7. UriComponentsBuilder.fromHttpUrl() 已移除

文件: BraveSearchToolBuilder.java

UriComponentsBuilder.fromHttpUrl(...) → UriComponentsBuilder.fromUriString(...)

运行时修复

8. Redis 容器 Bean 冲突

文件: DragWebSocket.java

// ❌ 两个 bean: redisContainer vs redisMessageListenerContainer
@Autowired(required = false)
private RedisMessageListenerContainer container;

// ✅ 指定 bean
@Qualifier("redisContainer")
@Autowired(required = false)
private RedisMessageListenerContainer container;

9. MongoDB 配置键改名

配置: application-*.yml (10个文件)

spring.data.mongodb.uri → spring.mongodb.uri

10. server.error.include-* 属性全部移除