启动报错：Invalid value type for attribute ‘factoryBeanObjectType‘ 解决方案

一、问题背景（真实踩坑场景）

最近在项目中将 Spring Boot 从 2.x 升级到 3.x ，数据库层使用的是 MyBatis-Plus 。

升级完成后，代码编译正常 ，但在 启动项目或运行单元测试时直接启动失败。

控制台抛出一个看起来非常 "抽象" 的异常：

rust 复制代码

java.lang.IllegalArgumentException: 
Invalid value type for attribute 'factoryBeanObjectType': java.lang.String

乍一看不像配置问题，也不像代码写错，但就是启动不了，非常影响开发效率。

二、错误现象（启动直接失败）

1️⃣ 启动时报错截图

实际项目中一般表现为 Spring Boot 启动到一半直接中断

markdown 复制代码

***************************
APPLICATION FAILED TO START
***************************

紧接着就是核心异常：

bash 复制代码

Invalid value type for attribute 'factoryBeanObjectType'

2️⃣ 单元测试同样失败

如果你在项目中写了 Mapper 层或 Service 层测试：

kotlin 复制代码

@SpringBootTest
class UserMapperTest {
    ...
}

运行测试时，也会在加载 Spring 上下文阶段直接失败。

三、完整错误堆栈（重点）

排查这个问题时，一定要把堆栈完整打出来，关键在这里：

dart 复制代码

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 时：

ini 复制代码

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 配置示例

xml 复制代码

<!-- 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：

xml 复制代码

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

这样可以避免不同模块依赖冲突。

七、辅助排查项（避免误判）

虽然不是根因，但也建议顺手检查：

less 复制代码

@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

✅ 单元测试正常执行

yaml 复制代码

Tests run: 5, Failures: 0, Errors: 0

到这里，说明问题彻底解决。

九、总结（踩坑经验）

❗ 很多人第一反应是改配置、改代码，其实方向就错了

这个错误：

❌ 不是 Mapper 写错
❌ 不是配置文件问题
❌ 不是 Spring Boot Bug

✅ 本质是 Spring Boot 3 与旧版 MyBatis 生态不兼容

✅ 记住这条经验

Spring Boot 大版本升级，ORM 框架一定要同步升级