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

问题情形     

        在使用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映射。

        

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

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

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

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

<javaClientGenerator targetPackage="com.woxin.itsm.mapper" targetProject="src/main/java" type="XMLMAPPER">

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

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

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

 

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