Spring Boot 3.2+ 升级Mybatis-Plus 3.5.x 兼容性问题与解决方案Invalid value type for attribute ‘factoryBeanObjectT

一、当升级遭遇滑铁卢

当我们将 Spring Boot 升级到 3.2.0+ 版本时，熟悉的 Invalid value type for attribute 'factoryBeanObjectType': java.lang.String 错误突然吞噬了控制台。这个看似神秘的错误频繁出现在整合 Mybatis-Plus 3.5.x 时，甚至会附赠 Invalid bean definition with name 'xxxMapper' 的组合拳攻击24。本文将通过实战踩坑经验，为你揭开这一问题的根本原因，并提供两种可靠的解决方案。

---

二、直击问题核心

1. 错误发生的根本原因

Spring Boot 3.2+（基于 Spring Framework 6.1+）要求强制适配 Jakarta EE 9+ 命名空间（jakarta.* 取代 javax.*），而 Mybatis-Plus 3.5.x 默认绑定的 mybatis-spring 模块仍使用旧版 javax.persistence 等包路径1。这种路径不兼容导致 Mapper 接口无法正确生成代理对象，从而触发类型转换异常。

2. 错误场景复现特征

• 使用 @MapperScan 注解或 @Mapper 接口时出现 Bean 定义错误
• Mapper XML 文件虽存在，但 Mybatis-Plus 无法识别接口类型
• 完整报错示例：

  org.springframework.beans.factory.BeanCreationException: 
  Invalid value type for attribute 'factoryBeanObjectType': java.lang.String

---

三、双解难题的利刃

方案一：官方推荐升级路线

适用场景： 希望快速稳定适配 Spring Boot 3.2+
操作步骤：

1. 替换依赖坐标
   将原来的 mybatis-plus-boot-starter 替换为 Spring Boot 3 专属分支：

   
       com.baomidou
       mybatis-plus-spring-boot3-starter
       3.5.5 
   

   此版本已适配 Jakarta 标准，并解决 mybatis-spring 兼容性问题1。

2. 调整 MySQL 驱动命名空间
   确保 JDBC URL 使用新版 cj 驱动：

   spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
   spring.datasource.url=jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai

---

方案二：保守方案（手动兼容）(推荐)

适用场景： 项目已深度绑定旧版 Mybatis-Plus，需逐步升级
操作步骤：

1. 强制指定依赖版本

   
       com.baomidou
       mybatis-plus-boot-starter
       3.5.3.2
       
           
               org.mybatis
               mybatis-spring
           
       
   
   
   
       org.mybatis
       mybatis-spring
       3.0.3 
   

2. 注解扫描验证

   @SpringBootApplication
   @MapperScan(basePackages = "com.example.mapper")
   public class Application {}

---

四、避坑指南

1. 必须检查的伴随依赖

• Spring Data JPA：确保与 Spring Framework 6.1+ 版本匹配（如 3.2.0+）5
• Druid：使用 druid-spring-boot-3-starter
• Swagger/SpringDoc：替换为 springdoc-openapi-starter-webmvc-ui

2. 版本适配对照表

组件	Spring Boot 3.2+ 适配版本
Mybatis-Plus	≥3.5.5 (Boot3 Starter)
HikariCP	5.0.1+
MySQL Driver	8.0.33+
Lombok	1.18.30+

---

五、总结与预告

通过替换 Starter 或精准控制依赖版本，我们成功跨越了 Spring Boot 3.2+ 与 Mybatis-Plus 的兼容鸿沟14。升级过程实质上是技术债的偿还，也是向现代化技术栈的迁移。