MyBatis-Plus与Spring Boot 3.4.1兼容性问题解析

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus

问题背景

在使用MyBatis-Plus 3.5.10.1与Spring Boot 3.4.1集成时，开发者遇到了一个典型的兼容性问题。系统在初始化Mapper时会抛出BeanDefinitionStoreException异常，错误信息显示"Invalid value type for attribute 'factoryBeanObjectType': java.lang.String"。

问题本质

这个问题源于MyBatis-Plus依赖的mybatis-spring组件版本与Spring Boot 3.4.1不兼容。具体来说，MyBatis-Plus 3.5.10.1默认依赖的mybatis-spring版本较旧，无法正确处理Spring Boot 3.x系列中的Bean定义类型检查。

技术细节分析

Spring Boot 3.x对Bean定义的处理机制进行了优化，特别是在处理工厂Bean时对类型检查更加严格。当Spring容器尝试获取Mapper接口的类型信息时，旧版的mybatis-spring返回了不正确的类型信息，导致Spring无法正确解析Bean定义。

解决方案

对于这个问题，开发者提供了两种解决方案：

1. 临时解决方案：通过Maven排除旧版mybatis-spring依赖，并显式引入3.0.4版本：

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.10.1</version>
    <exclusions>
        <exclusion>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>3.0.4</version>
</dependency>

2. 推荐解决方案：直接使用专为Spring Boot 3设计的mybatis-plus-spring-boot3-starter依赖，这个starter已经解决了与Spring Boot 3.x的兼容性问题。

最佳实践建议

对于使用Spring Boot 3.x的项目，建议：

1. 优先考虑使用mybatis-plus-spring-boot3-starter
2. 如果必须使用标准starter，确保mybatis-spring版本不低于3.0.4
3. 定期检查MyBatis-Plus的版本更新，官方会持续优化与Spring Boot的兼容性

总结

这个问题展示了框架版本间兼容性的重要性。随着Spring生态的快速发展，相关组件需要及时跟进适配。MyBatis-Plus团队已经为Spring Boot 3.x提供了专门的starter，开发者应该根据自己使用的Spring Boot版本选择合适的依赖配置，以避免类似的兼容性问题。

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus