【已解决】SpringBoot3项目整合Mybatis-plus启动项目报错：Invalid bean definition with name ‘xxxMapper‘ defined in flle

---

问题描述

最近，在SpringBoot v3.3.3的项目中整合Mybatis-plus后，启动项目时报了错：Invalid bean definition with name 'hotSearchMapper' defined in file [E:\project\EasyHotSearch\target\classes\com\fc\easyhotsearch\mapper\HotSearchMapper.class]: Invalid value type for attribute 'factoryBeanObjectType

报错截图如下

报错堆栈信息如下:

org.springframework.beans.factory.BeanDefinitionStoreException: Invalid bean definition with name 'hotSearchMapper' defined in file [E:\project\EasyHotSearch\target\classes\com\fc\easyhotsearch\mapper\HotSearchMapper.class]: Invalid value type for attribute 'factoryBeanObjectType': java.lang.String
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.getTypeForFactoryBean(AbstractAutowireCapableBeanFactory.java:857) ~[spring-beans-6.1.12.jar:6.1.12]
	at org.springframework.beans.factory.support.AbstractBeanFactory.getType(AbstractBeanFactory.java:743) ~[spring-beans-6.1.12.jar:6.1.12]
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.findAnnotationOnBean(DefaultListableBeanFactory.java:735) ~[spring-beans-6.1.12.jar:6.1.12]
	at org.springframework.boot.sql.init.dependency.AnnotationDependsOnDatabaseInitializationDetector.detect(AnnotationDependsOnDatabaseInitializationDetector.java:36) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.boot.sql.init.dependency.DatabaseInitializationDependencyConfigurer$DependsOnDatabaseInitializationPostProcessor.detectDependsOnInitializationBeanNames(DatabaseInitializationDependencyConfigurer.java:152) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.boot.sql.init.dependency.DatabaseInitializationDependencyConfigurer$DependsOnDatabaseInitializationPostProcessor.postProcessBeanFactory(DatabaseInitializationDependencyConfigurer.java:115) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.context.support.PostProcessorRegistrationDelegate.invokeBeanFactoryPostProcessors(PostProcessorRegistrationDelegate.java:363) ~[spring-context-6.1.12.jar:6.1.12]
	at org.springframework.context.support.PostProcessorRegistrationDelegate.invokeBeanFactoryPostProcessors(PostProcessorRegistrationDelegate.java:197) ~[spring-context-6.1.12.jar:6.1.12]
	at org.springframework.context.support.AbstractApplicationContext.invokeBeanFactoryPostProcessors(AbstractApplicationContext.java:789) ~[spring-context-6.1.12.jar:6.1.12]
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:607) ~[spring-context-6.1.12.jar:6.1.12]
	at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:146) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:754) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:456) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:335) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1363) ~[spring-boot-3.3.3.jar:3.3.3]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1352) ~[spring-boot-3.3.3.jar:3.3.3]
	at com.fc.easyhotsearch.EasyHotSearchApplication.main(EasyHotSearchApplication.java:12) ~[classes/:na]
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:na]
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:77) ~[na:na]
	at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:na]
	at java.base/java.lang.reflect.Method.invoke(Method.java:568) ~[na:na]
	at org.springframework.boot.devtools.restart.RestartLauncher.run(RestartLauncher.java:50) ~[spring-boot-devtools-3.3.3.jar:3.3.3]

---

原因分析

一般来讲，org.springframework.beans.factory.BeanDefinitionStoreException: Invalid bean definition with name ‘xxxxMapper’ defined in file [xxxx.class] … 这样的异常多半是由以下原因造成：

1. xxxxMapper接口没有@Mapper注解
2. application.properties或application.yml配置文件中的mybatis.mapper-locations属性没有正确指向了你的Mapper XML文件或者启动类使用了@MapperScan注解没有指定Mapper接口所在的包。

但是还有一些情况很特殊，即 SpringBoot的版本与MyBatis-Plus 的版本不兼容，也会导致SpringBoot无法扫描到所定义的mapper。

• SpringBoot2所兼容的MyBatis-Plus依赖如下所示：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>Latest Version</version>
</dependency>

• SpringBoot3所兼容的MyBatis-Plus依赖如下所示：

<dependency>
     <groupId>com.baomidou</groupId>
     <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
     <version>Latest Version</version>
</dependency>

---

解决方案

前提：确认项目中mapper接口已标注@Mapper注解，并且启动类上@MapperScan注解已指定mapper所在的包

确认无误后 ，根据上述原因分析，检查自己项目SpringBoot 版本与MyBatis-Plus依赖的版本是否兼容，若不兼容，修改相应pom文件中MyBatis-Plus的依赖版本即可

我的项目引入的MyBatis-Plus的依赖版本如下：

 <!-- mybatis-plus -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.5</version>
        </dependency>

项目中SpringBoot版本如下：

	<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.3.3</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

显然地，SpringBoot 版本与MyBatis-Plus依赖的版本不兼容！！！

修改如下：

        <!-- https://mvnrepository.com/artifact/com.baomidou/mybatis-plus-spring-boot3-starter -->
        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
            <version>3.5.7</version>
        </dependency>

再次启动项目

---

参考资料

• mybatis-plus GitHub仓库主页README说明
• SpringBoot3整合MyBatisPlus时遇到的问题及解决办法