Springboot整合mybatis中Invalid bound statement not found: 相关问题总结

问题分析

通常情况下报错信息是：

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.yo.news.user.mapper.UserMapper.getUserByTelPwd。

造成原因分析

造成原因通常为一下几点：

1. mapper.xml文件名与mapper接口名称写的不一样；
2. mapper.xml文件与mapper接口所在package不一样；
3. mapper.xml文件中的namespace命名空间书写错误；
4. mapper.xml文件中定于的id与接口中的方法名称不对应，如图：
   

解决方案

1，mapper.xml文件名与mapper接口名称写的不一样

这个问题基本复制粘贴方法名就能解决

2，mapper.xml文件与mapper接口所在package不一样

maven项目的约定配置文件必须放resources里，src目录下的xml文件默认不会编译到target。

所以解决上述问题的方案有两种

1，把xml放到resources目录中去，前提必须要注意的是，一定要建立与mapper接口相同的包资源路径！！！ps：这是大多数人都会范的错误，必须要规范建立路径，具体入图：

可能有的人觉得你写的是对的啊，其实不一定，因为idea中的包机制跟目录机制不同，所以不能以建立包的方式建立目录，例如在Java目录下（也就是src目录）:
在idea中new——》Java class 输入以下代码会建立包与类

com.lyf.oracle.mapper.OracleMapper

可是在resource目录中不能像刚刚一样链式建目录，必须一层一层的new——》Dirtory建立目录。

给大家看一下如果在resource下链式建立dirtory的效果 （绝对路径）：

D:\browserDownloads\oracle\target\classes\com\lyf\oracle\mapper\OracleMapper.class （src下的mapper）
D:\browserDownloads\oracle\target\classes\com.lyf.oracle.mapper\OracleMapper.xml（resource下的mapper.xml）
_明显下面的路径跟上面的不一样，一个是斜杠一个是点

下面这个图是非常明显的对比
resources下的第一个mapper是一个一个建的dirctory
resources下的第二个mapper是一次性链式建的dirctory

2，在maven中引入依赖，使的mapper.xml文件可以不放在resource目录下：

<!--此maven用于描述项目相关的所有资源路径列表，如项目属性文件，程序运行后会把资源被包含在最终的打包文件里。-->
<resources>
    <resource>
        <!--   描述存放资源的目录，该路径相对POM路径 路径要写对，我这个是瞎写的-->
        <directory>src/main/java</directory>
        <includes>
            <include>/*/*/*.xml</include>
        </includes>
    </resource>
</resources>

3， mapper.xml文件中的namespace命名空间书写错误；

mapper.xml文件的命名空间是当前mapper接口路径加+mapper接口名称！
如图：

4， mapper.xml文件中定于的id与接口中的方法名称不对应；

这个问题基本都能自己解决

补充一点

其实可以不用在配置文件中配置相关扫描路径，
但是我还是配置了，代码如下：

# yml 语法  配置在application.yml中
mybatis:
  mapper-locations: classpath*:com/lyf/oracle/mapper/*.xml

#启动类添加注解
@MapperScan("com.lyf.oracle.mapper")

总结

如果出现**org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)**错误，一般的原因是Mapper interface和xml文件的定义对应不上，需要检查包名，namespace，函数名称等能否对应上，需要比较细致的对比，按以下步骤一一执行：

1、检查xml文件所在的package名称是否和interface对应的package名称一一对应

2、检查xml文件的namespace是否和xml文件的package名称一一对应

3、检查函数名称能否对应上。

---

最后希望能帮到大家，不要搬运。