Spring Boot 项目与JDK、Mybatis版本兼容对应关系表及问题记录
作者：Star Treks
之前项目开发中遇到了版本不兼容的问题，这里记录主要为了方面后面查找对应，若遇到新的会继续更新。。。
一、Spring Boot 与 JDK 版本对应
Spring Boot 的不同版本对JDK有特定的支持范围。选择合适的JDK版本可以确保框架的稳定性和功能完整性。
| Spring Boot 版本 | 支持的最低 JDK 版本 | 支持的最高 JDK 版本 |
|---|---|---|
| 2.6.x | 8 | 17 |
| 2.7.x | 8 | 17 |
| 3.0.x | 17 | 20 |
| 3.1.x | 17 | 21 |
| 3.2.x | 17 | 21 |
说明：
- Spring Boot 2.6.x：适用于JDK 8到17，适合需要使用较早Spring Boot版本的项目。
- Spring Boot 2.7.x：适用于JDK 8到17，适合现有项目逐步迁移。
- Spring Boot 3.x：全面支持JDK 17及以上版本，利用最新的Java特性和性能优化。
推荐做法： 使用与Spring Boot版本兼容的最新稳定JDK版本，以获得最佳性能和安全性。
二、Spring Boot 与 MyBatis 版本兼容性
MyBatis 是常用的持久层框架，与Spring Boot的集成需要注意版本匹配，以避免兼容性问题。
| Spring Boot 版本 | MyBatis 版本 | mybatis-spring-boot-starter 版本 |
|---|---|---|
| 2.6.x | 3.4.x - 3.5.x | 2.1.x - 2.2.x |
| 2.7.x | 3.5.x | 2.2.x |
| 3.0.x | 3.5.x - 3.6.x | 3.0.x |
| 3.1.x | 3.5.x - 3.6.x | 3.0.x |
| 3.2.x | 3.5.x - 3.6.x | 3.0.x |
说明：
- Spring Boot 2.6.x：推荐使用 mybatis-spring-boot-starter 2.1.x 至 2.2.x 版本，与 MyBatis 3.4.x 至 3.5.x 兼容。
- Spring Boot 2.7.x：推荐使用 mybatis-spring-boot-starter 2.2.x 版本，与 MyBatis 3.5.x 兼容。
- Spring Boot 3.x：推荐使用 mybatis-spring-boot-starter 3.0.x 版本，支持 MyBatis 3.5.x 至 3.6.x。
注意事项：
- 依赖管理：尽量使用Spring Boot的依赖管理（BOM）来自动处理版本，减少手动指定版本的错误。
- 升级指南：在升级Spring Boot或MyBatis时，参考官方迁移指南，确保版本兼容。
三、Spring Boot 与 Spring Cloud 版本兼容性
Spring Cloud 提供了一系列分布式系统工具，与Spring Boot紧密集成。不同版本的Spring Cloud对应不同版本的Spring Boot。
| Spring Boot 版本 | Spring Cloud 版本 | 备注 |
|---|---|---|
| 2.6.x | 2021.x (Jubilee) | 适用于Spring Boot 2.6.x项目 |
| 2.7.x | 2021.x (Jubilee) | 适用于Spring Boot 2.7.x项目 |
| 3.0.x | 2022.x (Kilburn) | 支持Spring Boot 3.x及其新特性 |
| 3.1.x | 2022.x (Kilburn) | 持续支持与3.0.x相同的兼容性 |
| 3.2.x | 2022.x (Kilburn) | 未来版本可能更新，需关注官方发布信息 |
说明：
- Spring Cloud 2021.x (Jubilee)：适用于Spring Boot 2.6.x 和 2.7.x，提供成熟稳定的分布式工具。
- Spring Cloud 2022.x (Kilburn)：支持Spring Boot 3.x，利用其新的架构和特性。
推荐做法： 根据Spring Boot版本选择对应的Spring Cloud版本，确保两者之间的兼容性。
四、Spring Boot 与 Spring Cloud Alibaba 版本兼容性
Spring Cloud Alibaba 是基于Spring Cloud的Alibaba生态系统集成，适用于构建微服务架构。
| Spring Boot 版本 | Spring Cloud 版本 | 备注 |
|---|---|---|
| 2.6.x | 2021.x (China) | 适用于Spring Cloud Jubilee和Spring Boot 2.6.x |
| 2.7.x | 2021.x (China) | 适用于Spring Cloud Jubilee和Spring Boot 2.7.x |
| 3.0.x | 2022.x (China) | 支持Spring Cloud Kilburn和Spring Boot 3.x |
| 3.1.x | 2022.x (China) | 持续支持与3.0.x相同的兼容性 |
| 3.2.x | 2022.x (China) | 未来版本可能更新，需关注官方发布信息 |
说明：
- Spring Cloud Alibaba 2021.x (China)：与Spring Boot 2.6.x、2.7.x 和 Spring Cloud Jubilee 兼容。
- Spring Cloud Alibaba 2022.x (China)：支持Spring Boot 3.x 和 Spring Cloud Kilburn，适应新架构需求。
注意事项：
依赖冲突：确保Spring Cloud Alibaba的版本与Spring Cloud及Spring Boot版本一致，避免依赖冲突。
功能支持：不同版本的Spring Cloud Alibaba可能支持不同的功能模块，选择时需确认项目需求。
常见版本冲突及解决方案
在整合多种依赖时，版本冲突是常见的问题。以下列举了一些常见的版本冲突及其解决方案：
1. Spring Boot 与 MyBatis 版本不兼容
症状： 应用启动时报错，提示找不到某些MyBatis类或方法。
解决方案：
- 检查 mybatis-spring-boot-starter 的版本是否与Spring Boot兼容。
- 参考上述兼容性表，调整版本至匹配范围。
- 使用Spring Boot的依赖管理来自动处理版本。
2. Spring Cloud 版本与 Spring Boot 不匹配
症状： 启动时报错，提示Spring Cloud与Spring Boot版本不兼容。
解决方案：
- 确认Spring Cloud版本对应的Spring Boot版本。
- 更新Spring Cloud或Spring Boot至兼容版本。
- 避免手动指定Spring Cloud的版本，使用官方推荐的版本管理。
3. 依赖冲突导致的类加载错误
症状： ClassNotFoundException 或 NoSuchMethodError 异常。
解决方案：
- 使用 mvn dependency:tree（Maven）或 ./gradlew dependencies（Gradle） 查看依赖树，查找冲突依赖。
- 使用排除（exclusions）策略排除冲突的依赖版本。
- 确保所有子依赖的版本与主依赖版本一致。
4. JDK 版本不兼容
症状： 编译或运行时报错，提示不支持的JDK版本或特性。
解决方案：
- 检查Spring Boot版本对应的JDK支持范围。
- 升级或降级JDK版本以符合Spring Boot的要求。
- 确保开发环境和生产环境的JDK版本一致。
到此这篇关于Spring Boot 项目 与JDK、Mybatis版本兼容对应关系表的文章就介绍到这了,更多相关springboot与jdk mybatis对应关系表内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！
您可能感兴趣的文章:
- SpringBoot接入deepseek深度求索示例代码(jdk1.8)
- Java搭建一个springboot3.4.1项目 JDK21的详细过程
- IDEA无法创建JDK1.8版本的Springboot项目问题解决(2种方法)
- 查看SpringBoot和JDK版本对应关系的方法
- jdk17+springboot使用webservice的踩坑实战记录
- springboot新建项目jdk只有17/21,无法选中1.8解决办法
- springboot升级到jdk21最新教程(2023年)
- SpringBoot集成WebSocket的两种方式(JDK内置版和Spring封装版)
- Springboot整合mybatis-plus使用pageHelper进行分页(使用步骤)
- springboot集成mybatis-plus全过程