背景
有一个项目集成了mybatis-plus,是基于springboot的多模块项目做的,新写了xml后发现报了这个错 Invalid bound statement (not found), 就是mapper接口和mapper.xml没有映射起来,接着开始按照下面步骤排查原因。
排查步骤
检查 xml 文件,namespace 命名空间是否对应mapper,经检查无误。
检查 xml 文件里面,select标签的方法名是否对应,经检查无误
检查 xml 文件存放路径是否正确,经检查存放在resources下面,无误
因为使用mybatis-plus,检查是否配置了正确的位置,检查无误,
mybatis-plus:
mapper-locations: classpath*:mapper/*.xml
# 如果是mybatis的配置
mybatis:
mapper-locations: classpath*:mapper/*.xml
因为是springboot多模块,怀疑有mapper覆盖,其实上一步 classpath后跟着*,就会检查所有resources目录
仍然无效,遂无奈debug找原因
Debug步骤
首先介绍mybatis组件,因为启动时会SqlSessionFactory,通过SqlSessionFactoryBean注入,(因使用mybatis-plus,使用的是MybatisSqlSessionFactoryBean)其中会缓存所有xml文件与方法。有一个方法为 buildSqlSessionFactory ,在相关加载xml文件处打断点。debug启动后遂查看,发现注入为空,没有加载进来xml文件:
推断为mapper路径的配置问题,可是已经配置了mybatis-plus的 mapper-locations,为啥没加载进来呢,找到 MybatisPlusProperties 类,其中已经默认配置了路径。
遂推断bean加载的时候问题,一通寻找发现项目中因为是多数据源配置,重写了 MybatisSqlSessionFactoryBean, 查看代码
发现为这里的问题,遂重信写了个配置文件,手动加入mapper文件位置,
重新debug,xml文件已经加载进来。
再次测试接口,接口也正常了。
至此,问题解决完毕。