java mybatis怎么升级

在 Java 项目中“升级 MyBatis”通常分为几种场景，我按最常见情况给你说明，你可以对照自己的项目类型。

一、先确认你用的是哪种 MyBatis

1️⃣ 纯 MyBatis（mybatis）

依赖一般是：

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>3.x.x</version>
</dependency>

2️⃣ MyBatis-Spring（Spring 项目）

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis-spring</artifactId>
  <version>2.x.x</version>
</dependency>

3️⃣ MyBatis-Plus（国产增强）

<dependency>
  <groupId>com.baomidou</groupId>
  <artifactId>mybatis-plus-boot-starter</artifactId>
  <version>3.x.x</version>
</dependency>

二、Maven 项目升级方式（最常见）

✅ 修改 pom.xml 版本号即可

示例：升级 MyBatis 3.5.9 → 3.5.16

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis</artifactId>
  <version>3.5.16</version>
</dependency>

MyBatis-Spring 升级

<dependency>
  <groupId>org.mybatis</groupId>
  <artifactId>mybatis-spring</artifactId>
  <version>3.0.3</version>
</dependency>

⚠️ 注意版本匹配（见下文）

三、Spring Boot 项目推荐方式（最省事）

如果你是 Spring Boot，不要手动写 mybatis 版本，用官方 starter：

<dependency>
  <groupId>org.mybatis.spring.boot</groupId>
  <artifactId>mybatis-spring-boot-starter</artifactId>
  <version>3.0.3</version>
</dependency>

升级 Spring Boot 版本时，MyBatis 会自动跟着升级。

四、版本兼容关系（很重要）

MyBatis ↔ MyBatis-Spring

Spring Boot ↔ MyBatis Starter

五、升级后必须检查的点 ⚠️

1️⃣ XML 映射文件

• resultType / parameterType 是否还正确
• 是否使用了已废弃的标签

2️⃣ Java 代码

• SqlSession / Mapper 接口调用方式
• 是否用到已删除的 API（极少）

3️⃣ 日志

logging:
  level:
    org.mybatis: DEBUG

看启动是否有 SQL 或映射异常

六、Gradle 项目（如果你用的是 Gradle）

implementation 'org.mybatis:mybatis:3.5.16'
implementation 'org.mybatis:mybatis-spring:3.0.3'

七、如果你愿意，我可以更具体地帮你

你可以告诉我：

1. ✅ 用的是 MyBatis / MyBatis-Plus
2. ✅ Spring Boot 还是普通 Java 项目
3. ✅ 当前版本（旧 → 新）

我可以直接给你精准升级方案 + 可能踩的坑。