问题描述:
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接口方法一一对应即可。