【实战踩坑】Spring Boot 3.x 启动报错：Invalid value type for attribute ‘factoryBeanObjectType‘ 解决方案
一、问题背景（真实踩坑场景）
最近在项目中将 Spring Boot 从 2.x 升级到 3.x，数据库层使用的是 MyBatis-Plus。
升级完成后，代码编译正常，但在 启动项目或运行单元测试时直接启动失败。
控制台抛出一个看起来非常“抽象”的异常：
java.lang.IllegalArgumentException: Invalid value type for attribute 'factoryBeanObjectType': java.lang.String 乍一看不像配置问题，也不像代码写错，但就是启动不了，非常影响开发效率。
二、错误现象（启动直接失败）
1️⃣ 启动时报错截图
实际项目中一般表现为 Spring Boot 启动到一半直接中断
*************************** APPLICATION FAILED TO START *************************** 紧接着就是核心异常：
Invalid value type for attribute 'factoryBeanObjectType' 2️⃣ 单元测试同样失败
如果你在项目中写了 Mapper 层或 Service 层测试：
@SpringBootTest class UserMapperTest { ... } 运行测试时，也会在加载 Spring 上下文阶段直接失败。
三、完整错误堆栈（重点）
排查这个问题时，一定要把堆栈完整打出来，关键在这里：
Caused by: java.lang.IllegalArgumentException: Invalid value type for attribute 'factoryBeanObjectType': java.lang.String at org.springframework.beans.factory.support.FactoryBeanRegistrySupport .getTypeForFactoryBeanFromAttributes(FactoryBeanRegistrySupport.java:82) at org.springframework.beans.factory.support.AbstractBeanFactory .getTypeForFactoryBean(AbstractBeanFactory.java:1718) at org.springframework.beans.factory.support.AbstractBeanFactory .getType(AbstractBeanFactory.java:1648) 🔍 关键信息提取
- 出问题的不是业务代码
- 出问题的是 Spring 在解析 FactoryBean 类型
- 类型不合法：String
四、问题本质：不是你代码的问题，而是「版本不兼容」
1️⃣ Spring Boot 3.x 变“严格”了
Spring Boot 3.x 底层升级到 Spring Framework 6.x 后，对 FactoryBean 做了更严格的类型校验：
- ❌ 不再允许
factoryBeanObjectType是字符串 - ✅ 必须是：
Class- 或
ResolvableType
2️⃣ MyBatis / MyBatis-Plus 旧版本还在用老实现
旧版本的 mybatis-spring 或 mybatis-plus-starter 在注册 Mapper Bean 时：
factoryBeanObjectType = "com.xxx.UserMapper"; 这是一个 String 类型，在 Spring Boot 2.x 没问题，
但在 Spring Boot 3.x 会直接抛 IllegalArgumentException。
参考【mybatis-spring-issues 855】得知：
📌 一句话总结根因：
Spring Boot 3 规则升级了，但 MyBatis 生态没同步升级
五、哪些情况下必踩这个坑？
你可以对照看看是不是下面的情况：
- ✅ Spring Boot 升级到了 3.x
- ✅ 项目中使用了 MyBatis 或 MyBatis-Plus
- ✅ 没有刻意升级 mybatis-spring 版本
- ✅ 启动 / 测试时报 FactoryBean 相关异常
👉 满足 2 条以上，基本就是这个问题。
六、实战解决方案（亲测有效）
⭐ 方案一：升级 MyBatis-Plus + 显式指定 mybatis-spring（推荐）
这是最稳妥、最推荐的解决方式。
Maven 配置示例
<!-- MyBatis-Plus Starter --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.5</version> <exclusions> <!-- 排除旧版本 mybatis-spring --> <exclusion> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> </exclusion> </exclusions> </dependency> <!-- 引入 Spring Boot 3 兼容版本 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>3.0.3</version> </dependency> 📌 重点说明
mybatis-spring 3.0.x是官方适配 Spring Boot 3 的版本- 不显式指定，很容易被 Starter 间接引入旧版本
⭐ 方案二：统一依赖版本（多模块项目推荐）
如果是企业项目或多模块工程，建议用 dependencyManagement：
<dependencyManagement> <dependencies> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>3.0.3</version> </dependency> </dependencies> </dependencyManagement> 这样可以避免不同模块依赖冲突。
七、辅助排查项（避免误判）
虽然不是根因，但也建议顺手检查：
@MapperScan("com.xxx.project.mapper") @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } - ✅ Mapper 包路径是否正确
- ✅ 没有重复扫描
- ✅ Mapper 接口不要用原始泛型
八、修复后验证（成功标志）
✅ 项目启动成功
Started Application in 3.1 seconds ✅ 单元测试正常执行
Tests run: 5, Failures: 0, Errors: 0 到这里，说明问题彻底解决。
九、总结（踩坑经验）
❗ 很多人第一反应是改配置、改代码，其实方向就错了
这个错误：
- ❌ 不是 Mapper 写错
- ❌ 不是配置文件问题
- ❌ 不是 Spring Boot Bug
✅ 本质是 Spring Boot 3 与旧版 MyBatis 生态不兼容
✅ 记住这条经验
Spring Boot 大版本升级，ORM 框架一定要同步升级
