Spring Boot、MyBatis、MyBatis-Plus 依赖版本对应关系总结
在使用 Spring Boot、MyBatis 和 MyBatis-Plus 时，确保它们的依赖版本兼容是项目正常运行的关键。版本不兼容可能会导致诸如 sqlSessionFactory、sqlSessionTemplate 未正确配置等错误。因此，合理选择各个依赖的版本尤为重要。以下是 Spring Boot 各个版本与 MyBatis 和 MyBatis-Plus 的版本对应关系总结。
1. Spring Boot、MyBatis、MyBatis-Plus 依赖版本对应关系表
| Spring Boot 版本 | MyBatis 版本 | MyBatis-Plus 版本 | MyBatis-Plus Starter 版本 |
|---|---|---|---|
| 2.7.x | 2.2.x | 3.4.x | 3.4.x |
| 3.0.x | 3.5.x | 3.5.x | 3.5.x |
| 3.1.x | 3.5.x | 3.5.x | 3.5.x |
| 3.2.x | 3.5.x | 3.5.x | 3.5.x |
2. 依赖选择说明
- MyBatis 版本：
- Spring Boot 2.x 版本推荐使用 MyBatis 2.x 系列。
- 从 Spring Boot 3.x 开始，推荐使用 MyBatis 3.5.x 系列。它是 MyBatis 当前最稳定的版本，支持最新的 Java 17 特性以及 Spring Boot 3.x API。
- MyBatis-Plus 版本：
- MyBatis-Plus 3.4.x 适用于 Spring Boot 2.x 系列。
- MyBatis-Plus 3.5.x 是与 Spring Boot 3.x 系列兼容的最佳选择。此版本优化了对 Java 17 和 Spring Boot 3.x 的支持，同时提高了性能和扩展能力。
- MyBatis-Plus Starter 版本：
mybatis-plus-boot-starter是 MyBatis-Plus 提供的整合 Starter，它包括了 MyBatis-Plus 所需的核心依赖和配置，可以简化项目配置过程。与 Spring Boot 2.x 使用 3.4.x 版本，与 Spring Boot 3.x 则使用 3.5.x 版本。
3. 版本选择注意事项
- 兼容性问题：如果在项目中遇到
sqlSessionFactory或sqlSessionTemplate配置错误，最常见的问题是 MyBatis 或 MyBatis-Plus 的版本与 Spring Boot 版本不兼容。务必确保三者的版本处于同一兼容范围内。 - Spring Boot 3.x 的变化：Spring Boot 3.x 与之前的版本有较大改动，特别是在模块化系统、Java 17 支持等方面。使用 MyBatis 和 MyBatis-Plus 的时候，一定要选择 3.5.x 版本，以便与 Spring Boot 3.x 更好地配合。