<think>好的，我现在需要帮助用户解决在
SpringBoot中同时
集成Mybatis和Mybatis-plus时出现的BindingException问题，具体错误是'
Invalid bound statement'。首先，我得回忆一下这个错误的常见原因以及可能的解决方案。
首先，用户提到同时
集成Mybatis和Mybatis-plus，这可能引起冲突。因为
Mybatis-plus本身是基于
Mybatis的增强工具，如果两者的版本或配置不兼容，可能会出现问题。比如，两者可能都尝试注册相同的Mapper接口，导致冲突。
接下来，我需要考虑常见的导致'
Invalid bound statement'的原因。根据之前的引用内容，这个错误通常是因为
Mybatis找不到对应的Mapper XML文件或者Mapper接口的绑定有问题。可能的原因包括：
1. Mapper接口
和XML文件的命名空间或方法名不一致。
2. XML文件未被正确扫描到，路径配置错误。
3. 配置文件中未正确指定mapper-locations。
4. 同时使用
Mybatis和Mybatis-plus时，配置冲突，比如两者都尝试扫描相同的路径或Mapper接口，导致覆盖或遗漏。
用户的情况是同时使用
Mybatis和Mybatis-plus，所以需要检查两者的配置是否有冲突。例如，是否同时配置了
Mybatis的mapper-locations
和Mybatis-plus的mapper-locations，导致其中一个被覆盖。或者，是否在配置类中同时使用了@MapperScan注解，指定了不同的包路径，导致冲突。
根据引用[3]，在application.yml中添加
mybatis-plus.mapper-locations配置可以解决类似问题。因此，用户可能需要确保XML文件的路径正确，并且配置文件中正确指定了mapper的位置。同时，由于同时
集成两个框架，可能需要分别配置它们的mapper-locations，确保都能被正确加载。
另外，版本兼容性也是一个重要因素。用户使用的Spring Boot 3.2.2
和Mybatis-plus 3.5.9，需要确认这两个版本是否兼容。可能还需要检查
Mybatis的版本是否与
Mybatis-plus兼容，是否存在已知的冲突问题。
还有一个可能性是Mapper接口没有被正确注册。如果用户同时使用了@Mapper
和Mybatis-plus的@MapperScan，可能会导致重复注册或遗漏。需要确保Mapper接口所在的包被正确扫描，并且没有重复的扫描配置。
最后，可能需要检查项目的结构，确保XML文件位于正确的资源目录下，如src/main/resources/mapper，并且在构建时被正确打包到类路径中。有时候，Maven或Gradle的配置可能导致资源文件未被正确复制，从而导致找不到XML文件。
总结可能的解决步骤：
1. 检查Mapper接口
和XML文件的命名空间、方法名是否一致。
2. 在配置文件中明确指定mapper-locations，确保路径正确。
3. 分开配置
Mybatis和Mybatis-plus的mapper扫描路径，避免冲突。
4. 检查版本兼容性，确保Spring Boot、
Mybatis和Mybatis-plus的版本相互兼容。
5. 确保构建工具正确打包了XML文件到类路径。
6. 使用@MapperScan注解时，正确指定需要扫描的包路径，避免重复或遗漏。
可能还需要建议用户检查日志，查看具体的错误信息，确认是哪个Mapper或XML文件未被找到，从而更有针对性地解决问题。</think>###
SpringBoot同时
集成MyBatis和MyBatis-Plus导致`
Invalid bound statement`的解决方案
当
SpringBoot同时
集成MyBatis和MyBatis-Plus时，可能出现`BindingException
: Invalid bound statement`错误，主要原因包括
**配置冲突
**、
**XML文件未扫描
**或
**Mapper接口注册失败
**。以下是分步解决方案：
---
#### 1.
**检查Mapper接口与XML文件的绑定关系
**
-
**规则
**：Mapper接口的
**全限定名
**（如`com.example.mapper.UserMapper`）必须与XML文件中的`namespace`字段完全一致，且方法名与XML中的`id`一致。
-
**示例
**：
```xml
<!-- UserMapper.xml -->
<mapper namespace="com.example.mapper.UserMapper">
<select id="selectById" resultType="User">
SELECT
* FROM user WHERE id = #{id}
</select>
</mapper>
```
-
**注意
**：若同时使用
MyBatis和MyBatis-Plus的注解（如`@Select`），需避免混用导致冲突[^3]。
---
#### 2.
**配置`mapper-locations`路径
**
-
**问题
**：
MyBatis-Plus默认扫描`
classpath*:/mapper/
**/
*.xml`，而
MyBatis可能未正确配置路径，导致XML文件未被加载。
-
**解决
**：在`application.yml`中
**显式指定XML路径
**，确保两者兼容：
```yaml
mybatis:
mapper-locations
: classpath:/
mybatis/
*.xml #
MyBatis的XML路径
mybatis-plus
:
mapper-locations
: classpath:/mapper/
*.xml #
MyBatis-Plus的XML路径
```
---
#### 3.
**分离
MyBatis和MyBatis-Plus的Mapper接口
**
-
**步骤
**：
1. 将
**原生
MyBatis的Mapper接口
**放在独立包（如`com.example.
mybatis.mapper`）。
2. 将
**MyBatis-Plus的Mapper接口
**放在另一包（如`com.example.
mybatisplus.mapper`）。
3. 使用`@MapperScan`分别指定扫描路径：
```java
@Configuration
@MapperScan
(basePackages = "com.example.
mybatis.mapper", sqlSessionFactoryRef = "
mybatisSqlSessionFactory")
@MapperScan
(basePackages = "com.example.
mybatisplus.mapper", sqlSessionFactoryRef = "
mybatisPlusSqlSessionFactory")
public class MultiDataSourceConfig {
// 配置多个SqlSessionFactory
}
```
-
**原因
**：避免两个框架扫描同一包，导致Mapper注册冲突[^1][^2]。
---
#### 4.
**检查依赖版本兼容性
**
-
**关键版本匹配
**：
| 组件 | 推荐版本 |
|---------------|------------------------|
| Spring Boot | 3.2.x |
|
MyBatis | 3.5.13 |
|
MyBatis-Plus | 3.5.6（与Spring Boot 3兼容） |
-
**依赖配置
**：
```xml
<dependency>
<groupId>org.
mybatis</groupId>
<artifactId>
mybatis</artifactId>
<version>3.5.13</version>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>
mybatis-plus-boot-starter</artifactId>
<version>3.5.6</version>
</dependency>
```
---
#### 5.
**验证资源文件打包结果
**
-
**检查点
**：确认XML文件在编译后位于`target/classes`下的正确路径。
-
**Maven配置
**：在`pom.xml`中添加资源过滤：
```xml
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>
**/
*.xml</include>
</includes>
</resource>
</resources>
</build>
```
---
#### 6.
**日志排查
**
-
**开启
MyBatis日志
**：在`application.yml`中设置：
```yaml
logging
:
level
:
com.example.mapper
: DEBUG
```
-
**观察输出
**：检查是否输出`Mapped
Statement`加载成功的日志，若无则说明绑定失败。
---
### 总结流程
1.
**分离配置
**：隔离
MyBatis和MyBatis-Plus的Mapper路径及配置。
2.
**显式指定XML路径
**：确保两者均能扫描到对应XML。
3.
**版本降级/升级
**：使用兼容的依赖版本。
4.
**验证打包结果
**：确认XML文件位于正确位置。
---
本文主要探讨了在Springboot多模块集成Mybatis时遇到的'Invalid bound statement (not found)'错误，强调了错误排查的两个关键步骤：检查接口namespace与Mapper.xml的对应一致性。同时，详细解释了classpath和classpath*在配置文件中的区别，指出classpath仅搜索class路径，而classpath*则会包括jar文件中的class路径。
最低0.47元/天 解锁文章
扫一扫
2726
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
