<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文件位于正确位置。
---
这篇博客主要涉及Mybatis-Plus的配置检查，包括mapper接口与XML定义的ID一致性验证，以及确认Maven是否正确打包XML文件。通过确保这些配置正确无误，可以保证项目的正常运行和数据操作的顺利进行。
扫一扫
590
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
