org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)问题解决方案。

问题描述：

      springboot整合了mybatis-spring-boot-starter后，访问数据库，出现如下异常：

2020-08-02 11:19:52.921 ERROR 1446 --- [nio-8080-exec-1] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.cwp.study.dao.user.mapper.UserDao.selectByPrimaryKey] with root cause

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.cwp.study.dao.user.mapper.UserDao.selectByPrimaryKey
	at org.apache.ibatis.binding.MapperMethod$SqlCommand.<init>(MapperMethod.java:235) ~[mybatis-3.5.5.jar:3.5.5]
	at org.apache.ibatis.binding.MapperMethod.<init>(MapperMethod.java:53) ~[mybatis-3.5.5.jar:3.5.5]
	at org.apache.ibatis.binding.MapperProxy.lambda$cachedInvoker$0(MapperProxy.java:115) ~[mybatis-3.5.5.jar:3.5.5]
	at java.util.concurrent.ConcurrentHashMap.computeIfAbsent(ConcurrentHashMap.java:1660) ~[na:1.8.0_212]
	at org.apache.ibatis.binding.MapperProxy.cachedInvoker(MapperProxy.java:102) ~[mybatis-3.5.5.jar:3.5.5]
	at org.apache.ibatis.binding.MapperProxy.invoke(MapperProxy.java:85) ~[mybatis-3.5.5.jar:3.5.5]
	at com.sun.proxy.$Proxy52.selectByPrimaryKey(Unknown Source) ~[na:na]
	at com.cwp.study.biz.user.service.impl.UserServiceImpl.getUser(UserServiceImpl.java:19) ~[classes/:na]
	at com.cwp.study.web.user.controller.UserController.getUser(UserController.java:19) ~[classes/:na]
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:1.8.0_212]
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:1.8.0_212]
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:1.8.0_212]
	at java.lang.reflect.Method.invoke(Method.java:498) ~[na:1.8.0_212]
	at org.springframework.web.method.support.InvocableHandlerMethod.doInvoke(InvocableHandlerMethod.java:190) ~[spring-web-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.method.support.InvocableHandlerMethod.invokeForRequest(InvocableHandlerMethod.java:138) ~[spring-web-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.ServletInvocableHandlerMethod.invokeAndHandle(ServletInvocableHandlerMethod.java:105) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.invokeHandlerMethod(RequestMappingHandlerAdapter.java:878) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.handleInternal(RequestMappingHandlerAdapter.java:792) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.mvc.method.AbstractHandlerMethodAdapter.handle(AbstractHandlerMethodAdapter.java:87) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1040) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:943) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1006) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:898) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:626) ~[tomcat-embed-core-9.0.37.jar:4.0.FR]
	at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:883) ~[spring-webmvc-5.2.8.RELEASE.jar:5.2.8.RELEASE]
	at javax.servlet.http.HttpServlet.service(HttpServlet.java:733) ~[tomcat-embed-core-9.0.37.jar:4.0.FR]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:231) ~[tomcat-embed-core-9.0.37.jar:9.0.37]
	at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:166) ~[tomcat-embed-core-9.0.37.jar:9.0.37]
	at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:53) ~[tomcat-embed-websocket-9.0.37.jar:9.0.37]
	at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:193) ~[tomcat-embed-core-9.0.37.jar:9.0.37]

相关异常截图如下：

问题原因：

由于我的mapper文件时放在src/main/java 代码目录下的，默认打包动作，在执行编译打包时没有把mapper.xml文件打包到类路径下。

如下图所示：

问题解决：

   打包项目时，增加对xml文件的支持。

对应配置如下：

      <!-- 资源目录 -->
            <resources>
                <resource>
                    <!-- 设定主资源目录  -->
                    <directory>src/main/java</directory>

                    <!-- maven default生命周期，process-resources阶段执行maven-resources-plugin插件的resources目标处理主资源目下的资源文件时，只处理如下配置中包含的资源类型 -->
                    <includes>
                        <include>**/*.xml</include>
                    </includes>

                    <!-- maven default生命周期，process-resources阶段执行maven-resources-plugin插件的resources目标处理主资源目下的资源文件时，不处理如下配置中包含的资源类型（剔除下如下配置中包含的资源类型）-->
                    <excludes>
                        <exclude>**/*.yaml</exclude>
                    </excludes>

                    <!-- maven default生命周期，process-resources阶段执行maven-resources-plugin插件的resources目标处理主资源目下的资源文件时，指定处理后的资源文件输出目录，默认是${build.outputDirectory}指定的目录-->
                    <!--<targetPath>${build.outputDirectory}</targetPath> -->

                    <!-- maven default生命周期，process-resources阶段执行maven-resources-plugin插件的resources目标处理主资源目下的资源文件时，是否对主资源目录开启资源过滤 -->
                    <filtering>true</filtering>
                </resource>
            </resources>

将以上配置加到项目pom.xml文件下的 <build></build>节点下即可。

如下图所示：

 

每个人的具体原因不尽相同,但根本原因还是在于对应的mapper接口对应的xml文件找不到。

可根据以下步骤逐个检查原因：

1：检查接口对应的xml文件里面的namspace是否和接口路径一样   

2：mybatis.mapper-locations属性配置的路径下是否可以找到接口对应的xml文件

3：dao接口类的方法是在xml中存在对应的sql方法

最后的最后如果还是找不出来问题来，通过debug,  看源码分析问题。

我遇到的这次问题，最终就是通过debug   mybatis框架源码逐步分析出来的。

下面我将把我分析的过程描述出来。

---------------------------------我是华丽的分隔线----------------------------

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)问题解决原因分析过程：

步骤一：找到抛异常附近的代码，DEBUG进入org.apache.ibatis.binding.MapperMethod.SqlCommand#SqlCommand 方法

 

 

步骤二：DEBUG 进入org.apache.ibatis.binding.MapperMethod.SqlCommand#resolveMappedStatement

 

步骤三：debug进入org.apache.ibatis.session.Configuration#hasStatement(java.lang.String, boolean)方法

步骤四：结果发现org.apache.ibatis.session.Configuration#mappedStatements 属性是空对象，里面没有值。此时我怀疑是在初始化Configuration的时候，没有把xml文件里的语句ID初始化进来。

因为Configuration是在生成SqlSessionFactory的时候进行实例化的，所以先定位到SqlSesiionFactory实例化的代码中。由于项目时集成了mybatis-spring-boot-starter 组件，所以在Mytatis的自动化配置类中进行debug调试代码，方法如下：org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration#sqlSessionFactory，找到configuration实例化的地方，如下图示所示：

步骤五：代码中逻辑大概是，如果配置文件里没有配置configuration的配置文件路径值，mybatis就自动实例一个Configuration对象。

跟着代码继续debug，关键点在于下面：

具体debug方法路径：

org.mybatis.spring.boot.autoconfigure.MybatisProperties#resolveMapperLocations

org.springframework.core.io.support.PathMatchingResourcePatternResolver#getResources

 

步骤六：以下是生成具体会话工厂bean的方法

org.mybatis.spring.SqlSessionFactoryBean#buildSqlSessionFactory，

由于在生成sql会话工厂过程中org.mybatis.spring.SqlSessionFactoryBean#mapperLocations 字符串数组没有资源，所以会导致生成不了对应的xml文件资源，org.apache.ibatis.session.Configuration#mappedStatements  即这个属性值为空，所以就找不到对应的语句ID映射的对象,故报错。因此只要我们把dao接口类对应的xml文件能够打包到类路径下，并且xml里面namespae值与接口类路径保持一致，以及xml里面的的方法名与dao接口方法一一对应即可。