Mybatis 是怎么实现字段映射的？

2026年01月06日

面试考察点

面试官提出这个问题，通常旨在考察以下几个方面：

对 MyBatis 核心执行流程的理解：候选人是否明白一次查询操作，从 JDBC ResultSet 到最终返回 Java 对象的完整链路中，MyBatis 在哪个环节、以何种方式介入了字段映射。
对 ORM “映射”本质的掌握：不仅仅停留在 “配置了 resultMap 就能映射” 的表面认知，而是深入了解其底层实现机制，特别是反射 (Reflection) 的应用。
对多种映射方式及其优先级的知识广度：候选人是否清楚 MyBatis 提供了多种灵活的映射策略（如自动映射、注解、XML ResultMap），以及它们之间的共存与优先级规则。
解决复杂映射问题的实践经验：通过了解其原理，能否推断出或解释在实际开发中遇到映射失败、映射错误等问题的排查思路和解决方案。

核心答案

MyBatis 的字段映射主要由其核心组件 DefaultResultSetHandler 负责。其实现原理可概括为：在获取到 JDBC ResultSet 后，通过反射机制，根据一套明确的规则，将结果集中的列数据填充到目标 Java 对象的对应属性中。

映射方式主要分为两种：

自动映射：基于列名与属性名的匹配规则（可配置，如开启驼峰命名转换）。
手动映射：通过 XML 中定义的 <resultMap> 或 Java 注解（如 @Results）来显式指定映射关系。

当同时存在多种映射方式时，遵循 “手动映射优先于自动映射” 的原则。

深度解析

原理与机制

映射过程的核心是 ResultSetHandler 接口及其默认实现 DefaultResultSetHandler。其工作流程可以简化为以下几步：

遍历结果集：DefaultResultSetHandler 遍历 ResultSet 的每一行。
确定映射规则：为当前行数据确定一个 ResultMap 对象。这个 ResultMap 可能来自：
- 显式定义的 <resultMap>（最高优先级）。
- 通过 @Results 注解定义。
- 在只有 resultType 时，MyBatis 会为此类型动态生成一个 ResultMap，其规则基于“自动映射”的配置。
创建目标对象实例：通过反射调用目标类的无参构造器，实例化对象。
按规则填充属性：
- 对于手动映射条目（<result>）：直接使用其定义的 column 和 property，通过反射调用 setter 方法或直接修改字段（如果配置了 autoMappingBehavior 为 FULL 且存在字段）进行赋值。
- 对于需要自动映射的属性：MyBatis 会将数据库列名按配置的规则（如 mapUnderscoreToCamelCase）转换为属性名，然后在对象类中查找同名的 setter 方法或字段进行赋值。这个过程同样依赖反射。
处理嵌套映射：如果 ResultMap 中包含 <association> 或 <collection>，则会递归调用此过程，创建并填充复杂的嵌套对象。

对比分析：自动映射 vs. 手动映射

特性	自动映射	手动映射（XML/注解）
配置便利性	高，零配置或仅需全局设置	低，每个复杂映射均需定义
灵活性	低，依赖严格的命名约定	极高，可处理任意列名与属性名关系、复杂嵌套、类型转换
性能	略高（内部有缓存动态生成的 `ResultMap`）	首次解析 XML/注解有开销，后续使用缓存，与自动映射差异极小
适用场景	表字段与对象属性命名规范、简单的 CRUD	字段名与属性名差异大、存在嵌套对象、一对多查询、需要自定义类型处理器

最佳实践与注意事项

明确配置自动映射行为：在 mybatis-config.xml 中设置 autoMappingBehavior。推荐设置为 PARTIAL（默认），它不会自动映射嵌套结果。明确设置 mapUnderscoreToCamelCase 为 true 可以更好地匹配 Java 命名规范。
```
<settings>
    <setting name="autoMappingBehavior" value="PARTIAL"/>
    <setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>
```
简单场景用自动，复杂场景用手动：对于字段名与属性名一一对应的简单对象，使用 resultType 享受自动映射的便捷。对于有关联、字段名不匹配或需要特殊类型处理的情况，务必使用 <resultMap>。
善用结果映射继承：使用 <resultMap> 的 extends 属性可以复用基础映射，减少重复配置。

常见误区

误区一：认为 resultType 和 resultMap 只能二选一。它们可以协同工作。在 <resultMap> 中，可以设置 autoMapping=”true”，让 MyBatis 先尝试自动映射未在 <resultMap> 中明确定义的属性，再用手动映射覆盖特定属性，非常灵活。
误区二：忽视 setter 方法的重要性。自动映射和大多数手动映射（默认通过 property）都依赖于对象的 setter 方法。如果属性没有 setter，即使列名匹配，映射也会失败，除非你配置了直接字段访问（不推荐，破坏封装）。
误区三：混淆 #{} 和 ${} 在映射中的作用。#{} 和 ${} 是用于 SQL 语句构建时的参数替换，与结果集的字段映射是完全不同的两个阶段。字段映射发生在 SQL 执行并拿到 ResultSet 之后。

总结

MyBatis 的字段映射本质是利用反射，通过 DefaultResultSetHandler 组件，按照手动映射（<resultMap>）优先、自动映射补充的规则，将 JDBC ResultSet 中的列数据填充到 Java 对象的属性中。理解这一过程，是解决复杂映射问题和进行性能调优的基础。

发布于2026年01月06日|16:43:55