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

来源:这里教程网 时间:2026-02-21 17:33:46 作者:

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

定义
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——选对路子,映射就不卡壳。

相关推荐