在 MyBatis 框架中，resultType 是一个高频使用的配置项，它决定了 SQL 查询结果如何映射到 Java 对象。对于刚接触 MyBatis 的开发者来说，理解 resultType 的工作原理和使用场景，是掌握 MyBatis 核心功能的关键一步。本文将从基础概念到高级用法，结合实际案例，深入解析 resultType 的应用场景与技巧，帮助读者快速掌握这一核心知识点。
一、什么是 resultType？
resultType 是 MyBatis 中用于指定 SQL 查询结果映射类型的属性。它的作用类似于一个“翻译官”，将数据库查询得到的字段数据，自动转换为 Java 对象中的属性值。
1.1 resultType 与 resultMap 的对比
在 MyBatis 中，除了 resultType，还有一个与之功能类似的属性 resultMap。两者的区别在于：
resultType：直接指定 Java 对象的类型（如 User、List
resultMap：需要显式定义字段与属性的映射关系，适用于复杂场景（如字段名不一致、嵌套对象等）。
比喻：
可以将 resultType 想象为“自动翻译器”，它假设你提供的 Java 对象和数据库字段完全匹配；而 resultMap 则是“人工翻译器”，允许你逐条调整翻译规则。
二、resultType 的基础用法
2.1 基础场景：单表查询
假设有一个 user 表，包含 id、name、age 字段，对应的 Java 对象为 User：
public class User {
private Integer id;
private String name;
private Integer age;
// 省略构造方法和 getter/setter
}
在 MyBatis 的 XML 映射文件中，使用 resultType 配置：
SELECT id, name, age FROM user WHERE id = #{id}
执行该 SQL 时，MyBatis 会自动将查询结果的 id、name、age 字段，映射到 User 对象的同名属性中。
2.2 多行结果与集合类型
若查询返回多行数据（如 SELECT * FROM user），可以通过 resultType 直接返回 List
SELECT id, name, age FROM user
此时，MyBatis 会自动将每一条记录转换为 User 对象，并封装到 List 中返回。
三、处理复杂场景的高级技巧
3.1 嵌套对象与集合
当 Java 对象包含嵌套属性（如 User 包含一个 Address 对象）时，可以通过 resultType 结合字段名前缀实现映射：
public class User {
private Address address;
// Address 包含 street、city 等属性
}
假设 SQL 返回字段为 address_street、address_city，可以通过以下方式配置：
SELECT
u.id,
a.street AS address_street,
a.city AS address_city
FROM user u
LEFT JOIN address a ON u.id = a.user_id
WHERE u.id = #{id}
此时，MyBatis 会自动根据字段名前缀（如 address_）将数据映射到 User.address 对象中。
3.2 动态类型转换
若查询结果需要根据条件返回不同类型的对象（如根据角色返回 Admin 或 Customer），可以通过 resultType 动态指定类型：
SELECT id, name, age, role FROM user WHERE id = #{id}
在 Java 代码中传入 userType 参数：
Map
params.put("id", 1);
params.put("userType", "com.example.Admin");
List users = mapper.selectUserWithType(params);
但需注意，此方法需确保目标类型字段与 SQL 返回字段完全匹配，否则可能导致数据丢失。
四、常见问题与解决方案
4.1 字段名与属性名不一致
如果数据库字段名和 Java 属性名不一致（如数据库字段为 user_name，属性名为 name），可以通过以下两种方式解决：
修改 SQL 字段别名：
SELECT user_name AS name FROM user
使用 resultMap 显式映射：
然后在 SQL 中引用该 resultMap：
SELECT id, user_name, age FROM user
4.2 类型转换错误
当数据库字段类型与 Java 类型不匹配时（如数据库返回 VARCHAR，Java 属性为 Integer），MyBatis 会抛出转换异常。此时可通过以下方式解决：
在 Java 属性中使用 String 类型，或在 SQL 中强制类型转换：
SELECT CAST(name AS UNSIGNED) AS age FROM user
自定义类型处理器：实现 TypeHandler 接口，覆盖类型转换逻辑。
五、最佳实践与性能优化
5.1 选择 resultType 还是 resultMap？
优先使用 resultType：当字段与属性完全匹配时，resultType 简洁高效，无需额外配置。
使用 resultMap：当存在字段名不一致、复杂嵌套对象或需要性能优化时，resultMap 提供更灵活的控制。
5.2 性能优化技巧
避免返回大对象：若查询仅需部分字段，建议通过 resultType 明确指定需要的属性，而非返回完整对象。
批量查询与分页：对于大数据量查询，建议结合 LIMIT 和分页工具（如 PageHelper），避免内存溢出。
六、总结
resultType 是 MyBatis 中连接数据库与 Java 对象的核心桥梁，它在简单场景下提供了高效、便捷的映射能力。通过本文的讲解，读者可以掌握以下关键点：
resultType 的基本配置与自动映射逻辑；
处理复杂场景（如嵌套对象、动态类型）的技巧；
常见问题的解决方案与最佳实践。
希望本文能帮助开发者在实际项目中灵活运用 resultType，提升 MyBatis 开发效率。如果遇到更复杂的场景（如多表关联映射），可以进一步研究 resultMap 的高级用法，逐步深入掌握 MyBatis 的核心功能。