Dapper如何映射多个对象 Dapper多表查询映射指南

Dapper通过Multi-Mapping、QueryMultiple和字典缓存三种方式处理多表关联：一对一用Query配合splitOn和委托组装；一对多用字典去重聚合；多独立结果集用QueryMultiple一次性查询。

Dapper 本身不自动处理多表关联的嵌套对象，但通过 Multi-Mapping（多映射） 和 QueryMultiple 两种核心方式，可以干净、高效地把一个或多个结果集映射到多个 .NET 对象。关键不是“能不能”，而是选对方法——取决于你查的是一对多、一对一，还是完全无关的多结果集。

用 Query 做一对一或多对一映射

这是最常用的方式，适合主从结构清晰、且从表最多一条记录的场景（比如 Post + User、Order + Customer）。Dapper 把一行结果按指定列“切开”，前半段给第一个类型，后半段给第二个类型，再由你写委托组装。

• SQL 中字段顺序必须和泛型参数顺序一致：先 T1 字段，再 T2 字段；别名建议显式写出，避免同名列冲突
• splitOn 参数必须准确指向第二个对象的主键列名（如 "UserId" 或 "CustomerId"），不能只写 "Id" —— 如果两张表都叫 Id，不加别名就容易错位
• 委托里要主动赋值，比如 (post, user) => { post.Owner = user; return post; }，Dapper 不会自动设属性
• 关联数据可能为 NULL（如 LEFT JOIN），记得在访问前判空：post.Owner?.Name

用字典缓存处理一对多（如文章+评论）

单行 SQL 返回多条子记录时（比如 1 篇文章带 5 条评论），Query 会生成 5 个重复的 Post 实例。正确做法是手动去重+聚合：

标签： app .net igs