在
使用 MyBatis 时，若出现提示 `
Property 'sqlSessionFact
ory'
or 'sqlSessionTemplate'
are required` 的配置错误，通常是因为 Spring 未能正确注入
MyBatis 所需的核心组件。以下是解决该问题的多种方式：
---
### 通过继承 `SqlSessionDaoSupp
ort` 注入 `SqlSessionFact
ory`
在 DAO 层可以通过继承 `SqlSessionDaoSupp
ort` 并
使用 `@Resource` 注解注入 `SqlSessionFact
ory`，以确保
MyBatis 的会话工厂正确初始化。该方式适用于基于 DAO 模式的项目结构：
```java
public class CommonDao extends SqlSessionDaoSupp
ort {
@Resource
public void setSqlSessionFact
ory(SqlSessionFact
ory sqlSessionFact
ory) {
super.setSqlSessionFact
ory(sqlSessionFact
ory);
}
}
```
业务 DAO 类可继承该基类以获得对 `SqlSessionTemplate` 的访问能力[^3]。
---
### 显式配置 `SqlSessionTemplate` Bean
在 Spring 配置类中显式定义 `SqlSessionTemplate` Bean 是一种更推荐的方式。该 Bean 是
MyBatis-Spring 提供的核心组件，具备线程安全性
和事务管理能力，确保 `SqlSession` 的正确
使用：
```java
@Bean
public SqlSessionTemplate sqlSessionTemplate(SqlSessionFact
ory sqlSessionFact
ory) {
return new SqlSessionTemplate(sqlSessionFact
ory);
}
```
该配置确保了 `SqlSessionTemplate` 能够基于 `SqlSessionFact
ory` 正确初始化，并在整个 Spring 容器中可用[^1]。
---
### 排除 `DataSourceAutoConfiguration` 避免冲突
在某些情况下，Spring Boot 自动配置的 `DataSourceAutoConfiguration` 可能与
MyBatis 的配置冲突，导致 `SqlSessionFact
ory` 或 `SqlSessionTemplate` 无法正确注入。此时可以通过在 `@
SpringBootApplication` 注解中排除该自动配置类：
```java
@
SpringBootApplication(exclude = DataSourceAutoConfiguration.class)
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
```
此方法可避免因自动配置冲突导致的异常[^2]。
---
### 检查依赖版本兼容性
若
使用的是 Spring Boot 3.x，需注意 `
mybatis-spring-boot-starter` 的版本兼容性问题。目前尚未正式发布的 3.x 版本适配 Spring Boot 3，需手动配置远程仓库并引入快照版本：
```xml
<dependencies>
<dependency>
<groupId>
org.
mybatis.spring.boot</groupId>
<artifactId>
mybatis-spring-boot-starter</artifactId>
<version>3.0.0-SNAPSHOT</version>
</dependency>
</dependencies>
<reposit
ories>
<reposit
ory>
<id>ossrh</id>
<name>OSS Snapshot reposit
ory</name>
<url>https://oss.sonatype.
org/content/reposit
ories/snapshots/</url>
<releases>
<enabled>false</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</reposit
ory>
</reposit
ories>
```
此方式可解决 Spring Boot 3 与
MyBatis 之间因版本不兼容导致的配置问题。
---
###
多数据源场景下的配置
在
多数据源场景中，需要为每个数据源分别配置 `SqlSessionFact
ory`
和 `SqlSessionTemplate`，并通过 `@Qualifier` 注解区分不同的模板实例：
```java
@Bean
@Primary
public SqlSessionTemplate primarySqlSessionTemplate(
@Qualifier("primarySqlSessionFact
ory") SqlSessionFact
ory sqlSessionFact
ory) {
return new SqlSessionTemplate(sqlSessionFact
ory);
}
@Bean
public SqlSessionTemplate secondarySqlSessionTemplate(
@Qualifier("secondarySqlSessionFact
ory") SqlSessionFact
ory sqlSessionFact
ory) {
return new SqlSessionTemplate(sqlSessionFact
ory);
}
```
这种配置方式确保每个数据源拥有独立的会话模板，避免了不同数据源之间的干扰。
---
###
本文解决在Springboot2.0.4整合Mybatis时遇到的Property'sqlSessionFactory'or'sqlSessionTemplate'areerequired异常。问题源于maven多项目继承中版本冲突，调整mybatis-spring-boot-starter版本后，项目正常启动。
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
扫一扫
