(报错记录)mybatis整合mybatis-plus错误org.apache.ibatis.binding.BindingException: Invalid bound statement

在将mybatis升级到mybatis-plus时遇到BindingException,错误原因是mapper接口未被正确扫描注册。解决办法是确保mybatis-plus配置文件中扫描并注册了mapper接口。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.mindskip.xzs.repository.SubjectMapper.page
	at com.baomidou.mybatisplus.core.override.PageMapperMethod$SqlCommand.<init>(PageMapperMethod.java:261) ~[mybatis-plus-core-3.0.5.jar:na]
	at com.baomidou.mybatisplus.core.override.PageMapperMethod.<init>(PageMapperMethod.java:58) ~[mybatis-plus-core-3.0.5.jar:na]
	at com.baomidou.mybatisplus.core.override.PageMapperProxy.cachedMapperMethod(PageMapperProxy.java:70) ~[mybatis-plus-core-3.0.5.jar:na]
	at com.baomidou.mybatisplus.core.override.PageMapperProxy.invoke(PageMapperProxy.java:63) ~[mybatis-plus-core-3.0.5.jar:na]
	at com.sun.proxy.$Proxy101.page(Unknown Source) ~[na:na]
	at com.mindskip.xzs.service.impl.SubjectServiceImpl.lambda$page$94(SubjectServiceImpl.java:54) ~[classes/:na]
	at com.mindskip.xzs.service.impl.SubjectServiceImpl$$Lambda$660/261548855.doSelect(Unknown Source) ~[na:na]
	at com.github.pagehelper.Page.doSelectPageInfo(Page.java:353) ~[pagehelper-5.1.10.jar:na]
	at com.mindskip.xzs.service.impl.SubjectServiceImpl.page(SubjectServiceImpl.java:53) ~[classes/:na]
	at com.mindskip.xzs.controller.admin.EducationController.pageList(EducationController.java:38) ~[classes/:na]
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.0_45]
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:1.8.0_45]
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_45]
	at java.lang.reflect.Method.invoke(Method.java:497) ~[na:1.8.0_45]
	at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:190) ~[spring-web-5.1.8.RELEASE.jar:5.1.8.RELEASE]
	at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:138) ~[spring-web-5.1.8.RELEASE.jar:5.1.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:104) ~[spring-webmvc-5.1.8.RELEASE.jar:5.1.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:892) ~[spring-webmvc-5.1.8.RELEASE.jar:5.1.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:797) ~[spring-webmvc-5.1.8.RELEASE.jar:5.1.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:87
<think>好的,我现在需要帮助用户解决在SpringBoot中同时集成MybatisMybatis-plus时出现的BindingException问题,具体错误是'Invalid bound statement'。首先,我得回忆一下这个错误的常见原因以及可能的解决方案。 首先,用户提到同时集成MybatisMybatis-plus,这可能引起冲突。因为Mybatis-plus本身是基于Mybatis的增强工具,如果两者的版本或配置不兼容,可能会出现问题。比如,两者可能都尝试注册相同的Mapper接口,导致冲突。 接下来,我需要考虑常见的导致'Invalid bound statement'的原因。根据之前的引用内容,这个错误通常是因为Mybatis找不到对应的Mapper XML文件或者Mapper接口的绑定有问题。可能的原因包括: 1. Mapper接口和XML文件的命名空间或方法名不一致。 2. XML文件未被正确扫描到,路径配置错误。 3. 配置文件中未正确指定mapper-locations。 4. 同时使用MybatisMybatis-plus时,配置冲突,比如两者都尝试扫描相同的路径或Mapper接口,导致覆盖或遗漏。 用户的情况是同时使用MybatisMybatis-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. 分开配置MybatisMybatis-plus的mapper扫描路径,避免冲突。 4. 检查版本兼容性,确保Spring Boot、MybatisMybatis-plus的版本相互兼容。 5. 确保构建工具正确打包了XML文件到类路径。 6. 使用@MapperScan注解时,正确指定需要扫描的包路径,避免重复或遗漏。 可能还需要建议用户检查日志,查看具体的错误信息,确认是哪个Mapper或XML文件未被找到,从而更有针对性地解决问题。</think>### SpringBoot同时集成MyBatisMyBatis-Plus导致`Invalid bound statement`的解决方案 当SpringBoot同时集成MyBatisMyBatis-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> ``` - **注意**:若同时使用MyBatisMyBatis-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. **分离MyBatisMyBatis-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 ``` - **观察输出**:检查是否输出`MappedStatement`加载成功的日志,若无则说明绑定失败。 --- ### 总结流程 1. **分离配置**:隔离MyBatisMyBatis-Plus的Mapper路径及配置。 2. **显式指定XML路径**:确保两者均能扫描到对应XML。 3. **版本降级/升级**:使用兼容的依赖版本。 4. **验证打包结果**:确认XML文件位于正确位置。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值