<think>
我们面对的问题是：Spring Boot 应用启动时出现 `UnsatisfiedDependencyException`，最终原因是创建 `diskCommonBatchInfoMapper` 时失败，提示 `Property 'sqlSessionFactory' or 'sqlSessionTemplate' are required`。这表明 MyBatis 在初始化 Mapper 接口时，无法找到必需的 `SqlSessionFactory` 或 `SqlSessionTemplate` 实例。
### 原因分析
1
. **MyBatis 核心组件缺失**
- Spring 容器中缺少 `SqlSessionFactory` 或 `SqlSessionTemplate` 的
Bean 定义。
- 可能原因：
- 未正确配置 MyBatis（缺少 `@MapperS
can` 注解或 MyBatis 配置类）。
- 动态数据源（如分库分表组件）覆盖了默认的 MyBatis 配置，但未正确初始化自己的 `SqlSessionFactory`[^1]。
- 依赖冲突导致 MyBatis 自动配置失效（例如多个版本的 MyBatis 或 MyBatis-Spring 共存）。
2
. **动态数据源配置问题**
- 使用分库分表组件（如 ShardingSphere 或 dynamic-datasource）时，需要手动配置 `SqlSessionFactory` 以绑定到动态数据源。
- 如果组件配置错误（如数据源未成功初始化），会导致依赖它的 `SqlSessionFactory` 创建失败。
3
. **依赖冲突**
- 项目中可能存在多个版本的 MyBatis 相关依赖（如 `mybatis-spring`、`mybatis-spring-boot-starter` 等），导致自动配置类无法正常工作[^2]。
---
### 解决方案
#### 步骤 1：显式配置 SqlSessionFactory
在 Spring Boot 配置类中添加以下代码：
```java
@
Configuration
public class MyBatisConfig {
// 注入动态数据源（由分表组件管理）
@Autowired
private DataSource dataSource;
@
Bean
public SqlSessionFactory sqlSessionFactory() throws Exception {
SqlSessionFactory
Bean factory
Bean = new SqlSessionFactory
Bean();
factory
Bean
.setDataSource(dataSource); // 关键：绑定动态数据源
// 设置Mapper XML位置（按实际路径修改）
factory
Bean
.setMapperLocations(
new PathMatchingResourcePatternResolver()
.getResources("classpath:mapper/*
.xml"));
return factory
Bean
.getObject();
}
@
Bean
public SqlSessionTemplate sqlSessionTemplate() throws Exception {
return new SqlSessionTemplate(sqlSessionFactory());
}
}
```
#### 步骤 2：检查动态数据源配置
确保动态数据源已正确初始化：
1
. **验证数据源
Bean 是否存在**
在启动类中添加测试代码：
```java
@SpringBootApplication
public class Application {
public static void main(String[] args) {
ConfigurableApplicationContext ctx = SpringApplication
.run(Application
.class, args);
// 检查数据源
Bean
String[]
beanNames = ctx
.get
BeanNamesForType(DataSource
.class);
System
.out
.println("数据源
Bean列表: " + Arrays
.toString(
beanNames));
}
}
```
- 期望输出：包含动态数据源名称（如 `dynamicDataSource`）。
2
. **确认分表规则加载**
检查 Nacos 中的配置是否包含完整数据源定义和分片规则（参考问题中的引用配置模板）。
#### 步骤 3：解决依赖冲突
在 `pom
.xml` 中统一 MyBatis 相关依赖版本：
```xml
<!-- 锁定 MyBatis 全家桶版本 -->
<properties>
<mybatis-spring-boot-starter
.version>2
.3
.1</mybatis-spring-boot-starter
.version>
<dynamic-datasource-spring-boot-starter
.version>3
.6
.1</dynamic-datasource-spring-boot-starter
.version>
</properties>
<dependencies>
<!-- MyBatis 核心 -->
<dependency>
<groupId>org
.mybatis
.spring
.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>${mybatis-spring-boot-starter
.version}</version>
</dependency>
<!-- 动态数据源（如使用） -->
<dependency>
<groupId>com
.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
<version>${dynamic-datasource-spring-boot-starter
.version}</version>
<exclusions>
<!-- 排除冲突的 MyBatis 依赖 -->
<exclusion>
<groupId>org
.mybatis</groupId>
<artifactId>mybatis</artifactId>
</exclusion>
<exclusion>
<groupId>org
.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
</exclusion>
</exclusions>
</dependency>
</dependencies>
```
#### 步骤 4：添加 Mapper 扫描注解
在启动类或配置类上添加 `@MapperS
can`：
```java
@SpringBootApplication
@MapperS
can("com
.edms
.netdisk
.mapper") // 替换为你的 Mapper 包路径
public class Application {
public static void main(String[] args) {
SpringApplication
.run(Application
.class, args);
}
}
```
---
### 故障排查流程图
```mermaid
graph TD
A[启动报错：SqlSessionFactory缺失] --> B{是否配置动态数据源?}
B -->|是| C[检查动态数据源初始化]
C --> D[Nacos配置是否正确加载?]
D -->|否| E[修复Nacos配置]
D -->|是| F[检查依赖冲突]
B -->|否| G[检查MyBatis自动配置]
G --> H[是否有@MapperS
can?]
H -->|否| I[添加@MapperS
can]
H -->|是| J[检查Mapper XML路径]
F --> K[执行mvn dependency:tree]
K --> L{存在多个mybatis版本?}
L -->|是| M[排除冲突依赖]
L -->|否| N[检查SqlSessionFactory显式配置]
```
### 补充说明
- **动态数据源与 MyBatis 的协作原理**
分表组件会替换默认数据源为 `DynamicDataSource`，但 `SqlSessionFactory` 仍需手动绑定到该数据源（见步骤 1）。
- **依赖冲突的典型表现**
若日志中出现 `Class
NotFoundException` 或 `NoSuchMethodError` 与 MyBatis 相关，基本可判定依赖冲突。
通过以上步骤，可解决因 `SqlSessionFactory` 缺失导致的级联依赖注入失败问题。核心在于 **确保动态数据源生效** 和 **消除 MyBatis 组件冲突**。
§§相关问题§§
1
. 如何验证 Spring 容器中
Bean 的依赖关系图？
2
. MyBatis 动态数据源切换失败有哪些排查方法？
3
. Nacos 配置动态刷新后数据源不生效怎么办？
4
. Spring Boot 如何优雅地处理多数据源事务？
</think>
### 原因分析：`UnsatisfiedDependencyException` 与 `SqlSessionFactory` 缺失问题
该错误链的根本原因是 **MyBatis 核心组件未正确初始化**，导致 Mapper 接口无法创建。具体分析如下：
1
. **`SqlSessionFactory` 缺失（直接原因）**
MyBatis 要求每个 Mapper 必须绑定到 `SqlSessionFactory` 或 `SqlSessionTemplate`。当出现以下情况时会触发该错误：
- 未显式配置 `SqlSessionFactory`
Bean
- 动态数据源组件覆盖了默认的 MyBatis 自动配置
- 分表配置加载失败导致数据源未初始化
2
. **动态数据源配置问题（深层原因）**
分表场景下（如使用 ShardingSphere 或 dynamic-datasource）：
```mermaid
graph TD
A[Nacos 配置] --> B[动态数据源初始化]
B --> C[SqlSessionFactory 创建]
C --> D[Mapper 接口代理]
```
任一环节失败都会导致级联错误，尤其是：
- 分表规则配置错误（如 `actual-data-nodes` 路径不匹配）
- 物理数据库表未创建
- 数据源连接参数错误
3
. **依赖冲突（常见诱因）**
项目中同时存在多个 MyBatis 相关依赖时会产生冲突：
```java
// 典型冲突组合
mybatis-spring-boot-starter（2
.1
.0）
mybatis-plus-boot-starter（3
.5
.7） // 自带 MyBatis 3
.5
.x
dynamic-datasource-spring-boot-starter // 可能引入其他版本
```
不同版本的 `SqlSessionFactory
Bean` 初始化逻辑差异会导致组件创建失败[^2]。
---
### 解决方案
#### 第一步：修复 MyBatis 核心配置
在配置类显式声明
Bean：
```java
@
Configuration
public class MyBatisConfig {
// 注入动态数据源（由分表组件创建）
@Autowired
private DataSource dataSource;
@
Bean
public SqlSessionFactory sqlSessionFactory() throws Exception {
SqlSessionFactory
Bean factory
Bean = new SqlSessionFactory
Bean();
factory
Bean
.setDataSource(dataSource); // 关键绑定
factory
Bean
.setMapperLocations(
new PathMatchingResourcePatternResolver()
.getResources("classpath:mapper/*
.xml"));
return factory
Bean
.getObject();
}
}
```
#### 第二步：验证分表配置
检查 Nacos 中的分表规则（示例）：
```yaml
spring:
shardingsphere:
datasource:
names: ds0,ds1 # 分片数据源名称
ds0:
url: jdbc:mysql://127
.0
.0
.1:3306/db0?useSSL=false
ds1:
url: jdbc:mysql://127
.0
.0
.1:3306/db1?useSSL=false
rules:
sharding:
tables:
disk_common_batch_info: # 对应Mapper操作的实体
actual-data-nodes: ds$->{0
..1}
.disk_common_batch_info_$->{0
..3}
table-strategy:
standard:
sharding-column: batch_id
sharding-algorithm-name: mod4
```
#### 第三步：解决依赖冲突
在 `pom
.xml` 中统一版本：
```xml
<!-- 锁定 MyBatis 核心版本 -->
<dependency>
<groupId>org
.mybatis
.spring
.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2
.3
.1</version>
</dependency>
<!-- 排除 dynamic-datasource 中的冲突包 -->
<dependency>
<groupId>com
.baomidou</groupId>
<artifactId>dynamic-datasource-spring-boot-starter</artifactId>
<version>3
.6
.1</version>
<exclusions>
<exclusion>
<groupId>org
.mybatis</groupId>
<artifactId>mybatis</artifactId>
</exclusion>
</exclusions>
</dependency>
```
#### 第四步：验证物理表存在
在每个分片库执行 DDL：
```sql
-- 在 ds0 库执行
CREATE TABLE disk_common_batch_info_0 (
...);
CREATE TABLE disk_common_batch_info_1 (
...);
-- 在 ds1 库执行
CREATE TABLE disk_common_batch_info_2 (
...);
CREATE TABLE disk_common_batch_info_3 (
...);
```
---
### 预防措施
1
. **启动时检查配置加载**：
```java
@SpringBootApplication
public class Application {
public static void main(String[] args) {
ConfigurableApplicationContext ctx =
SpringApplication
.run(Application
.class, args);
// 检查数据源是否加载
Map<String, DataSource> datasources =
ctx
.get
BeansOfType(DataSource
.class);
System
.out
.println("加载数据源数量: " + datasources
.size());
}
}
```
2
. **启用 ShardingSphere SQL 日志**：
```yaml
spring:
shardingsphere:
props:
sql-show: true # 打印实际路由的SQL
```
通过以上步骤，可解决因动态数据源初始化失败导致的级联依赖注入错误。核心要点在于 **确保分表配置生效** 和 **消除 MyBatis 组件冲突**。
在使用ArcGIS Server发布包含MapService且勾选MobileDataAccess选项时，若遇到服务启动失败的问题，可通过设置自定义范围来解决。具体操作是在mxd文档的dataframe属性中，选择ExtentUsedByFullExtentCommand—>SpecifyExtent，从而避免默认范围不可接受导致的错误。
扫一扫
3974
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
