java.lang.IllegalArgumentException: Result Maps collection does not contain value for com.qau.my.mapper.DeptMapper.

### 关于MyBatis中`IllegalArgumentException: Result Maps collection does not contain value for DeptMapper` 在MyBatis框架中，当遇到`IllegalArgumentException: Result Maps collection does not contain value for DeptMapper`错误时，通常表明配置文件或映射关系存在问题。以下是对此问题的分析以及解决方案。 #### 错误原因 该错误的核心在于MyBatis无法找到指定的结果集映射（Result Map），即`DeptMapper`对应的`<resultMap>`未被正确注册到`Configuration`对象中[^4]。这可能涉及以下几个方面： 1. **XML配置文件缺失或不匹配** 如果`DeptMapper.xml`文件不存在或者其命名空间（namespace）与接口类名不符，则可能导致`addMapper`方法未能成功解析并注册相应的`<resultMap>`定义[^1]。 2. **`<resultMap>`标签未正确定义** `DeptMapper.xml`中的`<resultMap>`部分可能存在拼写错误、ID重复或其他语法问题，从而使得MyBatis无法识别所需的映射规则[^5]。 3. **动态加载顺序不当** 当通过程序代码手动设置`Configuration`实例时，如果先尝试获取某个尚未完成初始化的Mapper实例，也可能引发此类异常[^2]。 #### 解决方案 针对上述潜在的原因，可以采取以下措施来排查和修复问题： 1. **验证Mapper XML文件路径及名称一致性** 确保`DeptMapper.java`接口与其关联的`DeptMapper.xml`位于同一包下，并且两者的全限定名完全一致。例如： ```java package com.example.mapper; public interface DeptMapper { List<Department> findAll(); } ``` 对应的XML文件应当命名为`com/example/mapper/DeptMapper.xml`，并且其中需声明正确的命名空间： ```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.example.mapper.DeptMapper"> <!-- 定义结果集 --> <resultMap id="deptResultMap" type="com.example.model.Department"> <id property="id" column="DEPT_ID"/> <result property="name" column="DEPT_NAME"/> </resultMap> <!-- 查询语句 --> <select id="findAll" resultMap="deptResultMap"> SELECT * FROM DEPARTMENT </select> </mapper> ``` 2. **检查`<resultMap>`定义的有效性** 需要确认`DeptMapper.xml`内的`<resultMap>`是否具有唯一标识符（id），并与查询语句中的`resultMap`属性相匹配。此外还需注意字段映射逻辑是否合理[^3]。 3. **调整加载时机** 若项目采用Spring Boot集成方式开发，则可通过扫描机制自动装配所有Mapper；而对于纯Java应用而言，在启动阶段务必显式调用`SqlSessionFactoryBuilder.build()`方法构建Session工厂之前完成全部资源注入操作。 4. **调试日志辅助定位** 开启MyBatis的日志功能可以帮助开发者更直观地了解内部运行状态，进而快速发现配置层面存在的漏洞。例如修改logback配置如下所示： ```xml <logger name="org.apache.ibatis" level="DEBUG"/> ``` --- ### 示例代码片段 下面给出一段简单的测试代码用于演示如何正确配置并访问数据库表记录： ```java import org.apache.ibatis.session.SqlSession; import java.util.List; public class MainApp { public static void main(String[] args) throws Exception { SqlSession session = MyBatisUtil.getSqlSessionFactory().openSession(); // 假设已实现工具类封装 try { DeptMapper deptMapper = session.getMapper(DeptMapper.class); if (null != deptMapper) { List<Department> depts = deptMapper.findAll(); System.out.println("Total departments found:" + depts.size()); } else { throw new RuntimeException("Failed to load DeptMapper instance!"); } } finally { session.close(); } } } ``` ---