springboot整合mybatis-plus Caused by: java.lang.IllegalArgumentException: Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required

### 错误分析 当遇到`java.lang.IllegalArgumentException: Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required`错误时，表明应用程序尝试初始化MyBatis Plus组件时未能找到必要的SQL会话工厂或模板实例[^1]。 在Spring框架下，此异常通常意味着未正确配置MyBatis Mapper接口所需的依赖项。具体来说，在Spring的配置文件（无论是基于XML还是Java注解的方式），缺失了对`sqlSessionFactory`或`sqlSessionTemplate`属性的定义[^3]。 对于采用Spring Boot与MyBatis Plus集成的应用程序而言，该问题可能源于不兼容版本间的冲突。有报告指出，使用特定版本范围内的Spring Boot（如3.1.2）可以避免此类问题的发生；而更高版本可能会引发新的兼容性挑战[^4]。 ### 解决方案建议 为了修复上述提到的问题并成功实现Spring Boot和MyBatis Plus之间的无缝协作，可采取如下措施： #### 方法一：确保正确引入依赖库 确认项目中的构建工具（Maven/Gradle）已包含适当版本的MyBatis Spring包而非仅限于MyBatis Plus整合包。这有助于防止潜在的功能覆盖或遗漏。 ```xml <!-- Maven pom.xml --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>相应稳定版号</version> </dependency> <!-- 如果需要额外功能支持 --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>对应版本</version> </dependency> ``` #### 方法二：检查Bean注册情况 验证是否存在用于创建`SqlSessionFactory` Bean的方法，并将其暴露给整个应用上下文以便其他组件能够自动注入这些资源。可以通过自定义配置类来完成这项工作。 ```java @Configuration public class MyBatisConfig { @Bean(name = "sqlSessionFactory") public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception { final SqlSessionFactoryBean sessionFactory = new SqlSessionFactoryBean(); sessionFactory.setDataSource(dataSource); // 配置Mapper XML路径等... PathMatchingResourcePatternResolver resolver = new PathMatchingResourcePatternResolver(); sessionFactory.setMapperLocations(resolver.getResources("classpath*:mapper/*.xml")); return sessionFactory.getObject(); } } ``` #### 方法三：调整Spring Boot版本 如果当前使用的Spring Boot版本较高且遇到了难以解决的技术难题，则考虑回退到更稳定的较低版本（例如3.1.x系列）。这样做虽然不是长久之计，但在短期内可以帮助绕过某些尚未完全适配的新特性所带来的障碍。