springboot 整合mybatis时,junit单元测试或打包时报无法找到Mapper中声明的方法

时间:2025-04-21 08:58:24

背景

最近搭建了一个简单的springboot+mybatis+thymelaf的项目,但是项目写了部分数据库代码后跑单元测试提示找不到Mapper中声明的,即如下错误:

: Invalid bound statement (not found): xxx

之前测试的两个mapper方法都是能跑成功的,但现在也不行了,更蛋疼的是打包也报这个错误,但是直接启动项目,mapper里面的sql语句是能工作的,诡异的问题。

检查

确定以下配置没问题:

  • 在springboot 主类上加了@MapperScan 注解,并且设置了正确的包路径。
  • 在 中正确设置了xml文件的路径和model包的别名。
  • 将包含.xml mybatis的映射文件放在resource/mapper路径下
  • 打包后看到target/classes 下面有文件

但是就是springboot junit单元测试时,报上面提到的错误

最后的解决办法

其实最早玩Mybatis的时候,它要求 和 需要在同一个包下面,但是我这个直接放在mapper文件下,导致打包后没有和 在一个目录下,所以我想是不是这个原因导致的,试了一下果然可以。

即解决办法是: 将 resources下面的的文件夹层次结构改为和的包的层次结构相同,即如果的包路径是, 那么resources下面的的文件夹路径应该是com/sj/mapper/。

猜测:
假如不按照上面的方面,直接改 中的mapper 的namespace为看一下。