### MyBatis
多数据源下 '
Invalid bound statement (not found)' 错误
解决方案
在
多数据源场景中，MyBatis
报错 `
Invalid bound statement (not found)` 通常是由于配置
问题或 Mapper 文件未正确加载引起的。以下是可能导致该
问题的原因及
解决方法：
#### 1. **Mapper 接口与 XML 文件未正确关联**
- 确保 Mapper 接口的全限定名与对应的 XML 文件名称一致。例如，如果 Mapper 接口为 `com.example.mapper.UserMapper`，那么对应的 XML 文件应命名为 `UserMapper.xml` 并位于正确的路径下[^1]。
- 检查 XML 文件是否被正确加载到
Spring 容器中。可以通过设置 `mybatis.mapper-locations` 属性来指定 Mapper 文件的位置。例如：
```properties
mybatis.mapper-locations=classpath*:mapper/**/*Mapper.xml
```
#### 2. **
多数据源配置冲突**
- 在
多数据源场景下，每个
数据源需要独立配置其对应的 MyBatis 工厂和 SqlSessionFactory。确保每个
数据源的 Mapper 文件被正确加载到对应的 SqlSessionFactory 中[^3]。
- 使用动态
数据源切换时，需确保
切换逻辑正确。例如，在使用 `@DS` 注解时，必须保证注解值与配置的
数据源名称一致[^4]。
#### 3. **Mapper 扫描路径不正确**
- 如果使用了 `@MapperScan` 注解，需确保扫描路径包含所有 Mapper 接口所在的包。例如：
```java
@MapperScan
(basePackages = {"com.example.mapper.ds1", "com.example.mapper.ds2"}
)
public class MyBatisConfig {
// 配置代码
}
```
- 对于
多数据源场景，建议为每个
数据源单独配置一个 `@MapperScan`，并指定不同的 SqlSessionTemplate[^2]。
#### 4. **XML 文件未被正确加载**
- 如果使用的是 MyBatis-Plus，需检查是否正确设置了 `mapperLocations` 属性。例如：
```java
@Bean
@ConfigurationProperties
(prefix = "
spring.datasource.dynamic.primary"
)
public DataSource primaryDataSource
() {
return DataSourceBuilder.create
().build
();
}
@Bean
public SqlSessionFactory sqlSessionFactory
(DataSource dataSource
) throws Exception {
MybatisSqlSessionFactoryBean bean = new MybatisSqlSessionFactoryBean
();
bean.setDataSource
(dataSource
);
bean.setMapperLocations
(new PathMatchingResourcePatternResolver
()
.getResources
("classpath*:mapper/primary/*.xml"
));
return bean.getObject
();
}
```
#### 5. **动态 SQL 或自定义方法
问题**
- 如果 Mapper 方法未在 XML 文件中定义，或者方法签名与 XML 中的 `<select>`、`<insert>` 等标签不匹配，也会导致此错误。确保方法签名与 XML 文件中的 SQL 语句完全一致。
#### 6. **
Spring Boot 版本兼容性**
- 不同版本的
Spring Boot 和 MyBatis-Plus 可能存在兼容性
问题。例如，在
Spring Boot 3.x 和 MyBatis-Plus 3.5.9 的组合中，需确保所有依赖版本匹配。可以通过以下方式检查版本兼容性：
```xml
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-
boot-
starter</artifactId>
<version>3.5.9</version>
</dependency>
```
```java
// 示例：动态
数据源配置
@Configuration
public class DynamicDataSourceConfig {
@Bean
public DataSource dynamicDataSource
(DataSource primaryDataSource, DataSource secondaryDataSource
) {
DynamicRoutingDataSource dataSource = new DynamicRoutingDataSource
();
Map<Object, Object> targetDataSources = new HashMap<>
();
targetDataSources.put
("primary", primaryDataSource
);
targetDataSources.put
("secondary", secondaryDataSource
);
dataSource.setTargetDataSources
(targetDataSources
);
dataSource.setDefaultTargetDataSource
(primaryDataSource
);
return dataSource;
}
}
```
---
###
扫一扫
2536
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
