快捷導(dǎo)航

Spring Boot 2.x/3.x/4.x 版本兼容的最新MyBatis-Plus依賴

更新時(shí)間：2026年03月13日 08:24:37 作者：Sun 3285

本文主要介紹了Spring Boot 2.x/3.x/4.x 版本兼容的最新MyBatis-Plus依賴,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

背景

在 Spring Boot 最新的 4.0.3 版本（截止 2026 年 3 月 7 日）中，使用 MyBatis-Plus，在啟動(dòng)項(xiàng)目時(shí)，有如下報(bào)錯(cuò)：

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/

 :: Spring Boot ::                (v4.0.3)

2026-03-07T17:58:14.685+08:00  INFO 3028 --- [backend] [           main] com.sun3285.backend.BackendApplication   : Starting BackendApplication using Java 17.0.9 with PID 3028 (K:\項(xiàng)目\warehouse\backend\target\classes started by Sun3285 in K:\項(xiàng)目\warehouse)
2026-03-07T17:58:14.687+08:00  INFO 3028 --- [backend] [           main] com.sun3285.backend.BackendApplication   : No active profile set, falling back to 1 default profile: "default"
2026-03-07T17:58:14.994+08:00  WARN 3028 --- [backend] [           main] ConfigServletWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.BeanDefinitionStoreException: Invalid bean definition with name 'userMapper' defined in file [K:\項(xiàng)目\warehouse\backend\target\classes\com\sun3285\backend\mapper\UserMapper.class]: Invalid value type for attribute 'factoryBeanObjectType': java.lang.String
2026-03-07T17:58:14.997+08:00  INFO 3028 --- [backend] [           main] .s.b.a.l.ConditionEvaluationReportLogger : 

Error starting ApplicationContext. To display the condition evaluation report re-run your application with 'debug' enabled.
2026-03-07T17:58:15.005+08:00 ERROR 3028 --- [backend] [           main] o.s.boot.SpringApplication               : Application run failed

org.springframework.beans.factory.BeanDefinitionStoreException: Invalid bean definition with name 'userMapper' defined in file [K:\項(xiàng)目\warehouse\backend\target\classes\com\sun3285\backend\mapper\UserMapper.class]: Invalid value type for attribute 'factoryBeanObjectType': java.lang.String
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.getTypeForFactoryBean(AbstractAutowireCapableBeanFactory.java:857) ~[spring-beans-7.0.5.jar:7.0.5]
	at org.springframework.beans.factory.support.AbstractBeanFactory.getType(AbstractBeanFactory.java:740) ~[spring-beans-7.0.5.jar:7.0.5]
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.findAnnotationOnBean(DefaultListableBeanFactory.java:811) ~[spring-beans-7.0.5.jar:7.0.5]
	at org.springframework.boot.sql.init.dependency.AnnotationDependsOnDatabaseInitializationDetector.detect(AnnotationDependsOnDatabaseInitializationDetector.java:36) ~[spring-boot-sql-4.0.3.jar:4.0.3]
	at org.springframework.boot.sql.init.dependency.DatabaseInitializationDependencyConfigurer$DependsOnDatabaseInitializationPostProcessor.detectDependsOnInitializationBeanNames(DatabaseInitializationDependencyConfigurer.java:155) ~[spring-boot-sql-4.0.3.jar:4.0.3]
	at org.springframework.boot.sql.init.dependency.DatabaseInitializationDependencyConfigurer$DependsOnDatabaseInitializationPostProcessor.postProcessBeanFactory(DatabaseInitializationDependencyConfigurer.java:118) ~[spring-boot-sql-4.0.3.jar:4.0.3]
	at org.springframework.context.support.PostProcessorRegistrationDelegate.invokeBeanFactoryPostProcessors(PostProcessorRegistrationDelegate.java:363) ~[spring-context-7.0.5.jar:7.0.5]
	at org.springframework.context.support.PostProcessorRegistrationDelegate.invokeBeanFactoryPostProcessors(PostProcessorRegistrationDelegate.java:197) ~[spring-context-7.0.5.jar:7.0.5]
	at org.springframework.context.support.AbstractApplicationContext.invokeBeanFactoryPostProcessors(AbstractApplicationContext.java:795) ~[spring-context-7.0.5.jar:7.0.5]
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:603) ~[spring-context-7.0.5.jar:7.0.5]
	at org.springframework.boot.web.server.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:143) ~[spring-boot-web-server-4.0.3.jar:4.0.3]
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:756) ~[spring-boot-4.0.3.jar:4.0.3]
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:445) ~[spring-boot-4.0.3.jar:4.0.3]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:321) ~[spring-boot-4.0.3.jar:4.0.3]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1365) ~[spring-boot-4.0.3.jar:4.0.3]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1354) ~[spring-boot-4.0.3.jar:4.0.3]
	at com.sun3285.backend.BackendApplication.main(BackendApplication.java:12) ~[classes/:na]


Process finished with exit code 1

借助大模型，問題定位在：Invalid value type for attribute 'factoryBeanObjectType': java.lang.String。

根本原因?yàn)椋?strong>MyBatis-Plus 版本與 Spring Boot 4.0.3 不兼容。

此時(shí)，pom.xml 文件中，MyBatis-Plus 的依賴如下：

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

通過查閱資料，將 MyBatis-Plus 版本與 Spring Boot 版本進(jìn)行兼容后，啟動(dòng)項(xiàng)目無報(bào)錯(cuò)，運(yùn)行成功。

借此機(jī)會(huì)，以下對(duì)分別與 Spring Boot 2.x/3.x/4.x 版本兼容的最新 MyBatis-Plus 依賴（截止 2026 年 3 月 7 日）進(jìn)行總結(jié)。

Spring Boot 2.x 與 MyBatis-Plus 兼容

在 pom.xml 文件中，需要引入以下 MyBatis-Plus 的依賴（2026 年 1 月 11 日發(fā)布）：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.16</version>
    <scope>compile</scope>
</dependency>

Spring Boot 3.x 與 MyBatis-Plus 兼容

在 pom.xml 文件中，需要引入以下 MyBatis-Plus 的依賴（2026 年 1 月 11 日發(fā)布）：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
    <version>3.5.16</version>
    <scope>compile</scope>
</dependency>

Spring Boot 4.x 與 MyBatis-Plus 兼容

在 pom.xml 文件中，需要引入以下 MyBatis-Plus 的依賴（2026 年 1 月 11 日發(fā)布）：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-spring-boot4-starter</artifactId>
    <version>3.5.16</version>
    <scope>compile</scope>
</dependency>

到此這篇關(guān)于Spring Boot 2.x/3.x/4.x 版本兼容的最新MyBatis-Plus依賴的文章就介紹到這了,更多相關(guān)Spring Boot 版本兼容MyBatis-Plus 依賴內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: