mybatis错误:org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)

本文介绍了一个关于Spring Boot结合MyBatis Plus项目的常见错误:无法找到Mapper方法。文章详细分析了错误原因,并提供了具体的解决方案,包括检查XML文件配置、Mapper接口扫描配置等。

一、问题描述

运行项目,访问Controller提示错误如下:

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.fendo.plus.core.modules.sys.service.UserService.selectById
	at org.apache.ibatis.binding.MapperMethod$SqlCommand.<init>(MapperMethod.java:225)
	at org.apache.ibatis.binding.MapperMethod.<init>(MapperMethod.java:48)
	at org.apache.ibatis.binding.MapperProxy.cachedMapperMethod(MapperProxy.java:65)
	at org.apache.ibatis.binding.MapperProxy.invoke(MapperProxy.java:58)
	at com.sun.proxy.$Proxy71.selectById(Unknown Source)
	at com.fendo.plus.web.sys.LoginController.get(LoginController.java:47)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:498)
	at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:205)
	at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:133)
	at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:97)
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:827)
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:738)
	at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:85)
	at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:967)
	at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:901)
	at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:970)
	at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:861)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:635)
	at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:846)
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:742)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at com.alibaba.druid.support.http.WebStatFilter.doFilter(WebStatFilter.java:123)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.web.filter.RequestContextFilter.doFilterInternal(RequestContextFilter.java:99)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.web.filter.HttpPutFormContentFilter.doFilterInternal(HttpPutFormContentFilter.java:108)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.web.filter.HiddenHttpMethodFilter.doFilterInternal(HiddenHttpMethodFilter.java:81)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.springframework.web.filter.CharacterEncodingFilter.doFilterInternal(CharacterEncodingFilter.java:197)
	at org.springframework.web.filter.OncePerRequestFilter.doFilter(OncePerRequestFilter.java:107)
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193)
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166)
	at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:199)
	at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:96)
	at org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:478)
	at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:140)
	at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:81)
	at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:87)
	at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:342)
	at org.apache.coyote.http11.Http11Processor.service(Http11Processor.java:803)
	at org.apache.coyote.AbstractProcessorLight.process(AbstractProcessorLight.java:66)
	at org.apache.coyote.AbstractProtocol$ConnectionHandler.process(AbstractProtocol.java:868)
	at org.apache.tomcat.util.net.NioEndpoint$SocketProcessor.doRun(NioEndpoint.java:1459)
	at org.apache.tomcat.util.net.SocketProcessorBase.run(SocketProcessorBase.java:49)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1142)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:617)
	at org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)
	at java.lang.Thread.run(Thread.java:748)

二、解决方法


参看了网上的三种解决方法:

1、mybatis绑定错误
2、问个mybatis和spring security等结合出现的方法没找到问题

3、Spring整合MyBatis错误:Mapped Statements collection does not contain value for

总结起来出现上面那种错误的原因有如下几种情况:

1:检查xml文件所在的package名称是否和interface对应的package名称一一对应
2:检查xml文件的namespace是否和xml文件的package名称一一对应
3:检查函数名称能否对应上
4:去掉xml文件中的中文注释
5:随意在xml文件中加一个空格或者空行然后保存
6: mybatis的xml文件配置是否正确<property name="mapperLocations" value="classpath*:/mapper/**/*apper.xml"/>

注意:

还有注意的是你的mapper.xml文件是放在src/main/java目录下还是src/main/sources下,如果放在src/main/java下默认打包时xml文件是不加进去的,通过以下配置可解决:

      <resources>
          <resource>
              <directory>src/main/java</directory>
              <includes>
                  <include>**/*.xml</include>
              </includes>
          </resource>
          <resource>
              <directory>src/main/resources</directory>
          </resource>
      </resources>


由于他们用的是SpringMVC+Mybatis,而我这里用的是Spring Boot+Mybatis-Plus,所以出现错误的原因也是上面6种之一。

先看下我的项目结构与Mybatis扫描配置如下



mapper.xml文件如下:


mybatis-plus在application.yaml中的配置如下:

#mybatis
mybatis-plus:
  mapper-locations: classpath*:/mappings/**/*.xml
  #实体扫描,多个package用逗号或者分号分隔
  typeAliasesPackage: com.fendo.plus.entity
  global-config:
    #主键类型  0:"数据库ID自增", 1:"用户输入ID",2:"全局唯一ID (数字类型唯一ID)", 3:"全局唯一ID UUID";
    id-type: 2
    #字段策略 0:"忽略判断",1:"非 NULL 判断"),2:"非空判断"
    field-strategy: 2
    #驼峰下划线转换
    db-column-underline: true
    #刷新mapper 调试神器
    refresh-mapper: true
    #数据库大写下划线转换
    #capital-mode: true
    #序列接口实现类配置
    #key-generator: com.baomidou.springboot.xxx
    #逻辑删除配置(下面3个配置)
    logic-delete-value: 0
    logic-not-delete-value: 1
    sql-injector: com.baomidou.mybatisplus.mapper.LogicSqlInjector
    #自定义填充策略接口实现
    #meta-object-handler: com.baomidou.springboot.xxx
    #自定义SQL注入器
    #sql-injector: com.baomidou.springboot.xxx
  configuration:
    map-underscore-to-camel-case: true
    cache-enabled: false

报错的原因就是由于没有扫描到Mapper接口引起的:

@MapperScan("com.fendo.plus.core.modules*")//扫描dao或者是Mapper接口
//@MapperScan(basePackages = {"com.fendo.plus.core.modules.*.mapper"})
第一种是错的,改成第二种就可以了。。

### Spring Boot 3.2.5 使用 Gradle 构建时解决 MyBatis BindingException 错误 MyBatis 的 `BindingException` 错误通常表示在运行时无法找到绑定的 SQL 语句。这可能是由于 Mapper 接口与对应的 XML 文件未正确映射,或者配置文件中某些路径设置不正确导致的。 #### 1. 检查依赖配置 确保在 `build.gradle` 中正确添加了 MyBatis-Plus 和相关依赖项。以下是推荐的依赖配置: ```gradle dependencies { implementation 'com.baomidou:mybatis-plus-spring-boot3-starter:3.5.5' implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:3.0.3' } ``` 上述依赖项分别引入了 MyBatis-PlusMyBatis-Spring 支持[^2]。 #### 2. 配置 `application.yml` 确保 `application.yml` 中的 `mybatis-plus` 配置正确,特别是 `mapper-locations` 和 `type-aliases-package` 的路径设置。以下是一个示例配置: ```yaml mybatis-plus: mapper-locations: classpath*:/mapper/*Mapper.xml type-aliases-package: com.example.arrow_smart_toilet_back_01.mapper configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl global-config: db-config: id-type: auto ``` 如果项目使用的是自定义包名,请根据实际情况调整 `mapper-locations` 和 `type-aliases-package` 的值[^2]。 #### 3. 确保 Mapper 接口和 XML 文件匹配 `BindingException` 常见原因之一是 Mapper 接口与对应的 XML 文件未正确关联。请检查以下几点: - Mapper 接口是否被标注为 `@Mapper` 或通过 `@MapperScan` 注解注册。 - XML 文件是否放置在正确的目录下(例如 `src/main/resources/mapper/`)。 - XML 文件中的 `namespace` 属性是否与 Mapper 接口的全限定名一致。 例如,假设有一个名为 `UserMapper` 的接口,其 XML 文件应如下配置: ```xml <mapper namespace="com.example.arrow_smart_toilet_back_01.mapper.UserMapper"> <!-- SQL statements --> </mapper> ``` #### 4. 删除冗余配置类 如果项目中存在手动编写的 Druid 数据源配置类(如 `MysqlDruidConfiguration.java` 和 `DruidDataSourceProperties.java`),建议删除这些类。Spring Boot 已经内置了对 Druid 的支持,手动配置可能会导致冲突[^3]。 #### 5. 实现分页功能 如果需要实现分页功能,可以引入 `PageHelper` 相关依赖。以下是 Gradle 配置示例: ```gradle dependencies { implementation 'com.github.pagehelper:pagehelper-spring-boot-starter:2.1.0' } ``` 同时,确保在服务层代码中正确调用分页方法。例如: ```java import com.baomidou.mybatisplus.extension.plugins.pagination.Page; public List<User> getUserList(int page, int size) { Page<User> userPage = new Page<>(page, size); return userMapper.selectPage(userPage, null).getRecords(); } ``` #### 6. 调试与验证 如果问题仍然存在,可以通过以下方式排查: - 启用 MyBatis 日志输出,检查 SQL 执行情况。 - 确保项目构建后,XML 文件已正确打包到 `resources` 目录下。 --- ### 示例代码 以下是一个完整的 Mapper 接口和 XML 文件示例: #### Mapper 接口 ```java package com.example.arrow_smart_toilet_back_01.mapper; import com.baomidou.mybatisplus.core.mapper.BaseMapper; import com.example.arrow_smart_toilet_back_01.entity.User; import org.apache.ibatis.annotations.Mapper; @Mapper public interface UserMapper extends BaseMapper<User> { } ``` #### XML 文件 ```xml <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.example.arrow_smart_toilet_back_01.mapper.UserMapper"> <select id="selectById" resultType="com.example.arrow_smart_toilet_back_01.entity.User"> SELECT * FROM user WHERE id = #{id} </select> </mapper> ``` ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值