MyBatis 一对多关联映射详解

至于痛点一，一对多到底该怎么写？

在 MyBatis 的 XML 配置里一对多关系最常用的是标签，而不是错误地使用。说起来，很多人会把集合类型写成或者把元素类型写成这会导致 Mapper 根本无法识别集合。

再看痛点二，缺少主键导致数据重复

标签是唯一标识对象的关键。如果遗漏它，MyBatis 会把每行数据都当作新的父对象来实例化，从而出现大量重复对象。

再看痛点三。N+1 查询让性能崩溃

使用分布查询时如果一次查询得到 N 条父记录，每条记录访问子列表都会触发一次子查询，最终执行 1 + N 次 SQL 甚至更多。这在数据量大时会显著降低吞吐量。

典型场景举例

二、场景与实体类定义

数据库表结构

// 班级表
CREATE TABLE t_clazz (
cid INT PRIMARY KEY AUTO_INCREMENT。cname VARCHAR,location VARCHAR
);怎么说呢，// 学生表
CREATE TABLE t_student (
sid INT PRIMARY KEY AUTO_INCREMENT。sname VARCHAR,age INT,cid INT,FOREIGN KEY REFERENCES t_clazz
);// 示例数据
INSERT INTO t_clazz VALUES,;INSERT INTO t_student VALUES

Java 实体类

// Student
public class Student {
private Integer sid;private String sname;private Integer age;private Clazz clazz;// 多对一，可选
// getters/setters
}
// Clazz
public class Clazz {
private Integer cid;private String cname;private String location;private List students;// 一对多
// getters/setters
} 

三、两种映射方式详解

说到方式一。JOIN 查询 + 嵌套结果

A  推荐看看这种做法：A 单次 SQL 能同时拉取班级和学生信息，避免 N+ 查询。性能最高，代码最直观，

&不过，<nodefault resultMap="">
&<nodefault id="#cid"/>
&<nodefault property="cname"/>
&<nodefault property="color"/>
&<nodefault property="#students",ofType="#Student"/>
&<nodefault id="sid"/>
&按理说，<nodefault property="sname"/>
&不过，<nodefault property="height"/>
&<nodefault/>
&话说回来，&select id="#selectClazzWithStudents",resultMap="#ClazzStudentMap"/>
SELECT c.cid,c.cname。c.location,s.sid,s.sname,s.age
FROM t_clazz c LEFT JOIN t_student s ON c.cid=s.cid
WHERE c.cid = #{cid}
&//>/>

再看*关键点*，

• {@link #id} 标记必须存在否则 MyBatis 无法去重；否则每行都会产生新的 Clazz 对象。
• {#property} 与 {#column} 必须对应；说起来，若列名冲突，需要给列起别名。例如 s.sid AS sid_col.
• `ofType` 指定集合里元素的类型；`javaType` 通常留空，让框架默认 List.
• `fetchType` 默认 eager。可改为 lazy 当你确定不需要立即加载子列表时。
• `select` 用于分布查询；若无，则采用直接 JOIN。
• `column` 表示传递给子查询的参数名，在分布查询中非常关键。
**执行结果示例**： 此处省略后续行，但可看到同一个班级对应四个学生。

---

### **方式二：分布查询 + 延迟加载** xml SELECT cid,cname。location FROM t_clazz WHERE cid=#{cid} SELECT sid,sname,age FROM t_student WHERE cid=#{cid} **调用流程** java // 第一次只执行主 SELECT Clazz clazz = clazzMapper.selectClazzLazy;// SELECT cid,cname。... FROM t_clazz WHERE ... System.out.println);// 输出班级名称 // 第二次触发延迟加载 int size = clazz.getStudents.size;// SELECT sid,sname。... FROM t_student WHERE cid =?System.out.println;#### 优势与风险 * **优势** – 当你只关心部分父对象字段，不需要所有子对象时可节省网络/CPU 开销。* **风险** – 若随后访问了大量子列表，就会产生 N+ SQL。即使你开启了 `lazyLoadingEnabled=true`。--- ### 四、`collection` 标签属性速查

cid	cname	location	sid	sname	age
10	高三1班	A栋301	10100 张三;| |	;话说回来，| |	;| |	;| |	;| |	;| |	;| |

属性名	作用	示例值	注释
`property ` `students` ` ` `` `` `` `` `` `` `` ... --- ### 五、延迟加载配置细节 #### 全局开启 xml ` < ` setting name ='lazyLoadingEnabled' value ='true'/> ` setting name ='aggressiveLazyLoading' value ='false'/> #### 局部覆盖 xml --- ### 六、N+ 查询问题与方法 #### 问题描述 假设你通过分布式查询一次拿到 N 个班级： java List list = clazzMapper.selectAll;// 执行一次 SQL 获取所有班级 for { System.out.println.size);// 每次访问都触发一次 SQL → N 次!} 总共将执行 `1 + N * ` 条 SQL。#### 调整方法：统一 JOIN 查询 xml SELECT c.*,s.* FROM t_clazz c LEFT JOIN t_student s ON c.cid = s.cid WHERE c.cid IN ORDER BY c.cid 这样只需 **一次** SQL 即可获得所有所需信息。--- ### 七、级联操作技巧 如果想要插入一个班级并同时批量插入其学生，可以这么做： xml INSERT INTO t_clazz VALUES --- ### 八、常见错误快速排查清单 | 错误 | 正确做法 | 建议检查项 | |------|---------|-----------| | `` | `` | 检查是否误用了 javaType 而非 ofType | | 忘记 `` 标签 | `` | 确保每个 resultMap 都配置了主键映射 | | 列名冲突导致覆盖 | 给每列起别名，例如 `s.sid AS student_id`。`c.cid AS class_id` | 在 JOIN 时一定要加别名防止覆盖 | --- ### 九、常用方法速览 ... --- ### 十、与小结 建议在开始项目之前先确认一下： @link #ofType 必须填写，否则 MyBatis 无法实例化子对象；不要改用 javaType！→{} @link #id 必须配置，否则父对象会被拆散成多个实例；这也是最常见的数据重复原因！→{} @link #fetchType 为 lazy 时一定注意可能出现的 N+ 问题；如果你不确定，需要及时评估业务访问模式再决定是否开启懒加载。→{} @link #column 对应传递给子查询的参数名。一定要和子 mapper 接收参数一致，否则子查询返回空集。→{} @link #select 用来指定分布式子查询 ID。若未指定则默认为 join 查询，这种情况下不能再配合懒加载使用。→{} 场景  推荐方法  理由  普通读/写需求  'JOIN + 嵌套结果' '一次性获取全部信息，无 N+ 问题'