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 实例。正确做法是手动去重+聚合：

达芬奇

达芬奇——你的AI创作大师

166

查看详情

• 定义 Dictionary<int post> lookup = new()</int> 缓存已创建的 Post
• 在映射委托中，先查字典：有则复用，无则新建并加入字典，再把当前 Comment 加入其 Comments 集合
• SQL 仍用 JOIN，但最终返回的是 IEnumerable<post></post>，每个 Post 的 Comments 已填充好
• 注意：子对象主键列（如 CommentId）也要在 splitOn 中明确，否则 Dapper 不知道从哪开始读 Comment

用 QueryMultiple 一次查多个独立结果集

当你要查的数据彼此无关（比如同时加载用户列表 + 订单统计 + 配置项），或一对多关系太复杂不适合单 SQL JOIN 时，QueryMultiple 更稳：

• SQL 写成用分号隔开的多语句："SELECT * FROM Users; SELECT COUNT(*) FROM Orders; SELECT * FROM Configs"
• 调用 var multi = connection.QueryMultiple(sql)，然后依次 multi.Read<user>()</user>、multi.ReadSingle<int>()</int>、multi.Read<config>()</config>
• 数据库只走一次往返，性能比多次 Query 好，也避免了 JOIN 导致的数据膨胀
• 适合报表页、后台首页等需要聚合多种数据的场景

基本上就这些。没有银弹，一对一用 Multi-Mapping，一对多靠字典缓存，多结果集用 QueryMultiple——选对路子，映射就不卡壳。

以上就是Dapper如何映射多个对象 Dapper多表查询映射指南的详细内容，更多请关注php中文网其它相关文章！