<think>嗯，用户需要查询
MyBatis与
Spring框架的版本兼容性对照表。这个
问题很实际，因为版本不匹配会导致各种
奇怪的错误。从引用内容看，用户可能已经遇到兼容性
问题了，比如引用[3]提到启动失败的情况。
用户提供的引用材料很有价值。引用[1]和[3]都强调了版本对应的重要性，特别是引用[3]详细描述了
SpringBoot1.5.9与
MyBatisStarter2.1.4的搭配经验。引用[4]则帮助区分了
MyBatis系列技术的关系，这对理解版本依赖范围有帮助。需要重点解决的是：用户需要的是原始
MyBatis和
Spring框架的兼容表，但引用材料主要说的是
SpringBoot场景。这里要注意区分三层关系：1.底层是
MyBatis与
Spring核心容器的兼容性2.中间层是
MyBatis-
Spring桥接包的版本3.上层是
SpringBoot的自动
配置版本用户询问的是第一层和第二层。根据经验，最权威的参考是
MyBatis-
Spring官方文档的兼容性章节。应该引导用户查看该文档，同时提供典型版本对应示例（如
Spring5.x配
MyBatis3.5
+）。考虑到用户可能正在排错，需要补充常见错误场景：比如ClassNotFoundException通常就是jar包版本冲突导致的。引用[3]提到的启动失败案例就很典型，可以结合说明。
最后要提醒依赖管理技巧。用户可能不知道Maven的dependencyManagement能自动解决版本冲突，这个实用技巧应该包含在回答里。</think>以下是
MyBatis 与
Spring 框架版本兼容性的详细说明及对应关系表：
---
### **一、核心版本对应关系**
MyBatis 与
Spring 的兼容性主要通过 **`
mybatis-
spring` 桥接包**实现。以下是官方推荐的版本对照：
|
MyBatis 版本 |
Spring 版本 | `
mybatis-
spring` 版本 |
|--------------|-------------------|------------------------|
|
MyBatis 3.5
+ |
Spring 5.0
+ | 2.0
+ |
|
MyBatis 3.4
+ |
Spring 3.2.2
+ | 1.3
+ |
|
MyBatis 3.2
+ |
Spring 3.0.5
+ | 1.2
+ |
> 💡 **关键点**：
> - **`
mybatis-
spring` 是连接
MyBatis 和
Spring 的核心依赖**，必须严格匹配版本[^1][^3]。
> - 若使用
Spring Boot，需额外关注 `
mybatis-
spring-boot-starter` 的版本（见下文）。
---
### **二、
Spring Boot 场景下的版本兼容**
若项目基于 **
Spring Boot**，需使用 `
mybatis-
spring-boot-starter` 自动
配置包，其版本由
Spring Boot 主版本决定：
|
Spring Boot 版本 | `
mybatis-
spring-boot-starter` 版本 |
|------------------|-------------------------------------|
| 3.x | 3.0
+ (适配
MyBatis 3.5
+) |
| 2.5.x ~ 2.7.x | 2.2
+ (适配
MyBatis 3.5
+) |
| 2.1.x ~ 2.4.x | 2.1
+ (适配
MyBatis 3.5
+) |
| 1.5.x | 1.3.x (适配
MyBatis 3.4
+) |
#### 示例
配置（
Spring Boot 2.7）：
```xml
<dependency>
<groupId>org.
mybatis.
spring.boot</groupId>
<artifactId>
mybatis-
spring-boot-starter</artifactId>
<version>2.3.0</version> <!-- 兼容
Spring Boot 2.7.x -->
</dependency>
```
> ⚠️ **避坑指南**：
> - **
Spring Boot 1.x 仅支持
MyBatis 3.4.x**，若强行升级
MyBatis 会导致启动失败[^3]。
> - 始终通过 [
MyBatis-
Spring 官方文档](http://www.
mybatis.org/
spring-boot-starter/
mybatis-
spring-boot-autoconfigure/) 确认最新兼容性。
---
### **三、常见版本冲突解决方案**
1. **`NoSuchMethodError` 或 `ClassNotFoundException`**
- **原因**：`
mybatis-
spring` 与
MyBatis 核心版本不匹配。
- **解决**：根据上表降级/升级 `
mybatis-
spring`。
2. **
Spring Boot 启动失败**
- **原因**：
Spring Boot 父 POM 管理的
MyBatis 版本与手动引入版本冲突。
- **解决**：在 `pom.xml` 中显式指定版本：
```xml
<properties>
<
mybatis-
spring-boot-starter.version>2.3.0</
mybatis-
spring-boot-starter.version>
</properties>
```
3. **JDK 版本不兼容**
-
MyBatis 3.5
+ 需 **JDK 8
+**，
Spring Boot 3.x 需 **JDK 17
+**[^1][^3]。
---
### **四、权威参考来源**
1. **[
MyBatis-
Spring 官方文档](https://
mybatis.org/
spring/)**：查看核心兼容性表。
2. **[
MyBatis-
Spring-Boot 文档](http://www.
mybatis.org/
spring-boot-starter/)**：确认 Starter 与
Spring Boot 的对应关系[^3]。
3. **[
Spring Boot 版本支持](https://
spring.io/projects/
spring-boot#support)**：获取官方维护的版本生命周期。
---
本文介绍了使用SpringMVC+Spring+MyBatis时遇到的一个关于MyBatis版本的问题，详细说明了当使用MyBatis 3.4.X版本时出现的错误及解决方案，即通过将MyBatis版本回退到3.3.x来解决该问题。
扫一扫
3627
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
