之前项目开发中遇到了版本不兼容的问题，这里记录主要为了方面后面查找对应，若遇到新的会继续更新。。。
一、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版本一致。
本文参考链接：https://blog.csdn.net/m0_70871140/article/details/142426721
平台声明：以上文章转载于《CSDN》，文章全部或者部分内容、文字的真实性、完整性、及时性本站不作任何保证或承诺，仅作参考。
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
原文链接：https://blog.csdn.net/ZSJ406509/article/details/146231542
