项目场景:
最近小白在基与springboot+mybatis框架开发时,遇到了标题中的错误信息,原业务不方便公开,故本地模拟情况记录下来积累经验;
问题描述:
当我在开发新表的增删改查任务时,需要建立基本的功能模块,新建项目结构如下:
我需要写一个方法查询表里的全部数据,mapper接口如图:
对应xml文件如图:
启动类使用@MapperScan扫描mapper接口
然后我在测试类中,调用mapper中的queryAll()方法测试,如图:
启动后发生标题错误,具体如下:
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.javaboy.mybatismapper.mapper.SysAreaMapper.queryAll
原因分析:
出现这种报错的基本上是mapper接口对应xml文件mybatis框架没有找到,需要排查
解决方案:
问题可按如下步骤来排查解决:
1.检查xml文件是否编译到classes中
如果没有找到对应的xml文件,需要将xml编译进项目中,解决方案可以分为两种:
- 如果xml是放在/main/java目录下时,如本文例子,sysAreaMapper.xml时放在src/main/java/com/javaboy/mybatismapper/dao/SysAreaMapper.xml,需要修改pom文件:如图:
打包时将资源文件也打入jar中。
- 直接将xml文件放在resource目录下,这样可以不需要修改pom文件;如图:
!!!此处注意在resources下新建路径时,使用"/"作为分隔符,而不是“.”,切记切记,如图:
2. 如果第一步没有问题,则需要排查mapper接口和对应的xml是否在同一目录下(这也是我出错的地方,哎,基础太差了( ̄ー ̄);同样的,观察项目编译文件,
发现mapper,接口和xml文件不在同一目录下,修改xml位置如下图,
重新编译,启动,OK了~ 如图:
同理,如果xml是放在resource目录下的,只需要目录和java文件的目录保持一致就可以了,编译的时候mapper接口就和xml文件放在一起了,如图:
当然,如果公司有严格的代码要求,不允许修改项目结构,(比如小编我,mapper接口放在mapper文件下,xml放到dao文件下),mapper接口和xml文件是分开存放的,不能放在同一目录下,则可以通过修改配置文件,指定xml文件的路径也是可以的,在application配置文件中增加配置
mybatis.mapper-locations=classpath:com/javaboy/mybatismapper/dao/*.xml
!!!这里的分隔符需要使用"/",而不是".";
ps:如果项目中的mapper接口和xml文件名称不一样,比如user模块中mapper接口叫userMapper,xml文件叫userDao.xml;也会报文章标题的错误,这是也需要使用mybatis.mapper-locations指定xml位置;总结一下就是如果mapper接口和xml文件的名称和路径两者有一个不同,就需要使用mybatis.mapper-locations来指定的xml文件