MyBatis: No MyBatis mapper was found in '[xx.mapper]' package. Please check your configuration.

2022-05-25 14:38 30阅读 0赞

### 问题情形      ###

在使用SpringBoot集成MyBatis的过程中，项目正常启动，但控制台打出如下日志：

No MyBatis mapper was found in '[com.woxin.itsm.mapper]' package. Please check your configuration.

项目说明：

SpringBoot+MyBatis的通用Mapper+PageHelper+Generator+lombok+swagger

### 解决问题      ###

先说下出现问题的几种情形：

1，对应的Mapper目录写错了；

2，少了配置文件；

3，在应用入口类：XxxApplication.java中没有加入@MapperScan(basePackages = \{""\})注解；

4，注解方式不对，可使用@Mapper注解。

先帖出项目的结构目录，如下截图。分析日志信息，是说在项目itsm.mapper包下没有发现MyBatis mapper映射。

![70][]

从结构图中可以看下，包com.woxin.itsm.mapper这个路径没有错，也是有文件的（只是没的展开，其实是有的）。那为什么还是有这个错误呢？下面先具体说下项目的情况和思路

项目采用SpringBoot+MyBatis的通用Mapper+MyBatis PageHelper+Mbatis Generator+lombok+swagger，其中ItsmApplication.java是应用入口，如下图，在ItsmApplication.java中加了注解@MapperScan，包也没有写错，但就是有这个问题存在。

![70 1][]

此时我想到了mapper的配置文件，即在resources/mapper目录下的配置文件，会不会因为少了配置文件呢？因为我开发了用户的管理功能，已经有了User.java实体类，UserMapper.java，但是没有UserMapper.xml文件（原来有的，后来不小心给删了），于是写好了UserMapper.xml文件，再启动尝试就正常了。

另外要说明的是，在MyBatis Generator的配置文件mybatis-generator-config.xml文件中，配置了mapper的目录，这里不能写错，如下：

还有在application.properties文件中，配置了mapper配置文件的路径，也不能写错，如下：

#Mybatis配置
    mybatis.type-aliases-package=com.woxin.itsm.model  
    mybatis.mapper-locations=classpath:mapper/*.xml

最后是注解扫描mapper的配置，路径名也不能写错。

如果还是不行，那可以使用@Mapper注解了，这时候把应用入口的@MapperScan注解去掉，如下图，再在对应的XxxMapper.java加上@Mapper注解。

![70 2][]

![70 3][]

[70]: /images/20220525/f51947ca02564f99acdd162400d15a0a.png
[70 1]: /images/20220525/4a3c9b09c8344e53bed96ec46dd9de1a.png
[70 2]: /images/20220525/ec56d60238bf43349f9a264d17bc0551.png
[70 3]: /images/20220525/d23dcadfc9804275ac48a24adcbcb0b8.png