关于mybatis mapper类注入失败的解决方案

关于MyBatis Mapper类注入失败的解决方案

在MyBatis中，Mapper类是Dao层的接口，通过Mapper类调用到mapper.xml的sql语句执行相关操作。如果Mapper类注入失败，会导致无法进行相关的数据库操作。下面给出解决该问题的完整攻略。

1.检查Mapper类接口所在的包路径是否正确

在Spring Boot项目中，Mapper类通常位于src/main/java下的com.XXX.XXX.mapper包中。当创建Mapper类时，可能出现包路径错误导致接口找不到的情况。可以检查下实际的Mapper类包路径是否与预期一致。

例如：Mapper类的实际路径为com.example.mapper.UserMapper，但是在mybatis-config.xml 或 application.yml配置中，写成了com.example.dao.UserMapper。在这种情况下，MyBatis就会找不到UserMapper接口，注入失败导致无法进行数据库操作。修改包路径后即可解决该问题。

2.检查Mapper类和mapper.xml文件是否一一对应

Mapper类和mapper.xml文件应该一一对应，如果在Mapper类上定义了@Mapper注解，那么mybatis会自动到对应的mapper.xml文件中查找SQL语句进行注入，但是如果两者不对应，就会导致注入失败的问题。

例如，UserMapper类对应的mapper.xml文件为UserMapper.xml，但是在定义SQL语句时，却把SQL语句写在了BlogMapper.xml文件中，这样就无法进行注入生成相应的mapper实现类。修改mapper.xml文件即可解决该问题。

示例1：

package com.example.mapper;

import java.util.List;

import org.apache.ibatis.annotations.Select;
import org.springframework.stereotype.Repository;

import com.example.entity.User;

@Repository
public interface UserMapper {

    @Select("select * from user where id = #{id}")
    User findUserById(int id);

    void addUser(User user);

    void updateUser(User user);

    List<User> findAllUsers();
}

示例2：

<?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.example.mapper.UserMapper">
    <select id="findUserById" parameterType="int" resultType="com.example.entity.User">
        select * from user where id = #{id}
    </select>

    <insert id="addUser" parameterType="com.example.entity.User">
        insert into user(name, sex, age) values (#{name}, #{sex}, #{age})
    </insert>

    <update id="updateUser" parameterType="com.example.entity.User">
        update user set name=#{name}, sex=#{sex}, age=#{age} where id=#{id}
    </update>

    <select id="findAllUsers" resultType="com.example.entity.User">
        select * from user
    </select>
</mapper>