mybatis-plus的 mapper.xml 路徑配置的坑

mybatis-plus今天遇到一個問題，就是mybatis 沒有讀取到mapper.xml 文件。

特此記錄一下，問題如下：

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.husy.mapper.SystemUserMapper.findUserByName

    at com.baomidou.mybatisplus.core.override.MybatisMapperMethod$SqlCommand.<init>(MybatisMapperMethod.java:242)
    at com.baomidou.mybatisplus.core.override.MybatisMapperMethod.<init>(MybatisMapperMethod.java:54)
    at com.baomidou.mybatisplus.core.override.MybatisMapperProxy.lambda$cachedMapperMethod$0(MybatisMapperProxy.java:65)
    at java.util.concurrent.ConcurrentHashMap.computeIfAbsent(ConcurrentHashMap.java:1660)
    at com.baomidou.mybatisplus.core.override.MybatisMapperProxy.cachedMapperMethod(MybatisMapperProxy.java:65)
    at com.baomidou.mybatisplus.core.override.MybatisMapperProxy.invoke(MybatisMapperProxy.java:60)
    at com.sun.proxy.$Proxy72.findUserByName(Unknown Source)
    at com.husy.service.impl.SystemUserServiceImpl.findUserByName(SystemUserServiceImpl.java:23)

錯誤代碼如下：

mapper.xml 目錄（在resources目錄中的mapper）

代碼如下：

單元測試

@Test
public void findUser(){
    SystemUser systemUser= systemUserService.findUserByName("admin");
    System.out.println(systemUser.toString());
}

mybatis-puls 配置

@EnableTransactionManagement
@Configuration
@MapperScan("com.husy.mapper")
public class MybatisConfig {

    /**
     * mybatis-plus 分頁插件
     */
    @Bean
    public PaginationInterceptor paginationInterceptor() {
        return new PaginationInterceptor();
    }
}

service實現

@Service
public class SystemUserServiceImpl implements SystemUserService {
    @Autowired
    private SystemUserMapper userMapper;

    @Override
    public SystemUser findUserByName(String name) {
        return userMapper.findUserByName(name);
    }
}

mapper 接口

@Component
public interface SystemUserMapper {
    SystemUser findUserByName(@Param("userAccount") String name);
}

mapper.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.husy.mapper.SystemUserMapper">
    <resultMap id="systemUserMap" type="com.husy.domain.SystemUser" >
        <id column="user_id" property="userId"  />
        <result column="user_account" property="userAccount" />
        <result column="user_password" property="userPassword"  />
        <result column="user_phone" property="userPhone"  />
    </resultMap>
    <select id="findUserByName" resultMap="systemUserMap">
         SELECT
            user_id,
            user_account,
            user_password,
            user_phone
         FROM t_system_user
         where user_account = #{userAccount}
    </select>
</mapper>

通過上面的代碼可以看出。mapper接口中的方法和映射文件中的方法名稱是一樣的。不存在名稱錯誤導致的情況，返回值，參數類型等你都正確。如果找不到方法，那一定是映射文件配置問題，只有沒有讀取到，纔會出現找不到的情況。
我的配置如下：

問題出錯的關鍵位置
我這裏引用的是 mybatis-plus-boot-starte 依賴

<dependency>
    <groupId>com.baomidou</groupId>
     <artifactId>mybatis-plus-boot-starter</artifactId>
     <version>3.1.0</version>
 </dependency>

mapper.xml 的文件引用路徑配置如下：

mybatis.mapper-locations=classpath:mapper/*.xml

這就導致，mybatis 讀取不到 mapper映射文件。

經過查閱：

如果引用mybatis-plus-boot-starter 依賴，需要配置 mybatis-plus.mapper-locations
如果引用mybatis-plus 依賴，需要配置 mybatis.mapper-locations
如下：

引用 mybatis-plus 包

<dependency>
   <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus</artifactId>
    <version>3.1.0</version>
</dependency>

mybatis.mapper-locations=classpath:mapper/*.xml

引用 mybatis-plus-boot-starter 包

 

mybatis-plus.mapper-locations=classpath:mapper/*.xml