mybatis使用经验——报错"Invalid bound statement (not found)"的一种解决方法

分类:计算机 | 数据库 | Mybatis | 异常问题 274
更新:2022-01-21 01:29:40
编辑

1 异常描述

最近学习了一下若依管理平台的用法,在人家的项目源码里加了一些自己之前写的功能,项目运行起来后访问系统时发现某个功能的数据加载不出来,后台报错:

Invalid bound statement (not found): com.ruoyi.system.mapper.TArticleInfoMapperEx.selectTop10ArticleByPv

2 异常分析

从字面上看这个错误是因为mapper.java文件中的方法selectTop10ArticleByPv在对应的xml文件中找不到相匹配的内容,于是检查了一下我的mapper.xml文件和mapper.java文件,里面的信息都是能对应上的,没有什么问题。那么我分析有可能就是mapper.java文件根本就找不到对应的mapper.xml文件,而xml文件的位置是通过yml中mybatis的配置项mybatis.mapperLocations来配置的,问题可能出在这里,于是去查了一下这个配置项的内容,目前是这样的配置:

# MyBatis
mybatis:
    # 搜索指定包别名
    typeAliasesPackage: com.ruoyi.**.domain
    # 配置mapper的扫描,找到所有的Mapper.xml映射文件
    mapperLocations: classpath*:mapper/**/*Mapper.xml

这里的mybatis.mapperLocations属性通配符指定了mapper xml文件的匹配规则是:项目资源文件路径>mapper文件夹>任意名称的文件夹>xml文件名称以"Mapper"结尾的,问题就出在这里了,因为报错的这个mapper xml文件的名称是以"MapperEx"结尾的,所以按照规则找不到这个文件,就会报错。

3 异常解决

把mybatis.mapperLocations属性通配符的规则改成:项目资源文件路径>mapper文件夹>任意名称的文件夹>所有的xml文件,如下:

# MyBatis
mybatis:
    # 搜索指定包别名
    typeAliasesPackage: com.ruoyi.**.domain
    # 配置mapper的扫描,找到所有的xml映射文件
    mapperLocations: classpath*:mapper/**/*.xml