Spring Boot 项目 与 其他依赖版本兼容对应表

刚开始学习Java时，我遇到了许多问题，尤其是在选择JDK版本、Spring Boot以及MyBatis的版本时，常常会出现莫名其妙的错误。调试了很久才意识到，很多问题其实源自于依赖版本的不兼容。为了帮助大家在项目中少走弯路，我整理了这篇文章，总结了一些常见依赖版本的兼容性问题，希望对大家有所帮助。如果在阅读过程中遇到任何疑问，欢迎指正与交流。

一、Spring Boot 与 JDK 版本对应

Spring Boot 的不同版本对JDK有特定的支持范围。选择合适的JDK版本可以确保框架的稳定性和功能完整性。

说明：

• 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 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 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 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版本一致。

参考

• MyBatis Spring Boot Starter 官方文档
• Spring Boot 与 Spring Cloud 兼容性
• Springboot、mybatis、mybatis-spring-boot-starter、jdk、springcloud和springcloudalibaba等对应版本关系 - pz_ww - 博客园 (cnblogs.com)