Dapper如何映射到嵌套的复杂类型 Dapper深层对象映射

Dapper映射嵌套复杂类型依赖MultiMapping和自定义TypeHandler：MultiMapping处理1对1/1对多及最多7层泛型组合，TypeHandler支持JSON字段自动序列化，CustomTypeMap应对继承场景，需手动处理列名冲突、NULL关联与N+1问题。

Dapper 映射嵌套复杂类型，核心靠 MultiMapping（多对象映射）和 自定义 TypeHandler 两类机制。它不自动递归解析三层以上对象，也不支持原生的“深度导航属性”映射（比如 Post.Owner.Address.City），但通过组合策略完全可以实现清晰、可控的深层结构。

用 MultiMapping 处理 1 对 1 和 1 对多嵌套

这是最常用也最直接的方式，适用于两层或手动组装三层结构：

1 对 1（如 Post → User）：用 Query + splitOn 指定分割列（如 "UserId"），再在委托里赋值：
(post, user) => { post.Owner = user; return post; }
1 对多（如 Post → List）：不能直接用泛型 Query，需借助字典缓存父对象，遍历结果集时按外键聚合子项。常见写法是先查主表+关联表联合结果，再用 Lookup 或 GroupBy 分组组装
3 级嵌套（如 Post → User → Profile）：可扩展为 Query，最多支持 7 个泛型参数，splitOn 需传入逗号分隔字符串，如 "UserId,ProfileId"，Dapper 会依序切分字段段

用 TypeHandler 支持 JSON 字段反序列化

当深层结构不适合拆成多表 JOIN（比如用户配置、订单明细项列表），推荐把嵌套部分存为 JSON 字段，再用自定义 TypeHandler 自动转换：

数据库字段类型设为 VARCHAR(MAX) 或原生 JSON（SQL Server 2016+ / MySQL 5.7+ / PostgreSQL）
编写 JsonTypeHandler 类，重写 Parse 和 SetValue，用 System.Text.Json 处理序列化
注册一次：SqlMapper.AddTypeHandler(new JsonTypeHandler());
实体中直接声明 public Address ShippingAddress { get; set; }，Dapper 读写时自动处理

用 CustomTypeMap 处理继承或动态类型

当嵌套对象类型不固定（如基类 Notification 下有 EmailNotif、SmsNotif 子类），需靠 ITypeMap 实现运行时类型选择：

根据数据库中标识字段（如 NotifType 值为 "Email"）决定实例化哪个子类
继承 DefaultTypeMap 或实现 ITypeMap，在 GetMemberMaps 中注入逻辑
调用 SqlMapper.SetTypeMap(typeof(Notification), yourCustomMap) 全局生效
这样嵌套属性（如 User.PreferredNotif）就能返回具体子类型，而非空基类

避坑要点：别依赖自动深度映射

Dapper 不会像 EF Core 那样扫描导航属性并自动 JOIN。以下情况必须手动干预：

列名冲突（如两张表都有 Id）→ 务必用 SQL 别名：p.Id as PostId, u.Id as UserId，并让 splitOn 对应别名
NULL 关联数据（如未设置作者的帖子）→ 委托函数里判空：post.Owner = user ?? null;
性能敏感场景 → 避免 N+1 查询，优先用单次 JOIN + MultiMapping，而不是循环查子对象
字段过多影响映射 → 只 SELECT 实际需要的列，避免 SELECT * 导致 splitOn 错位

基本上就这些。Dapper 的嵌套映射不是“全自动”，但每一步都透明可控，写清楚 splitOn、写好映射委托、配对好 TypeHandler，深层结构也能很稳。

# mysql # js # json # app # ai # red # sql # NULL # 子类 # select # 字符串 # 递归 # 循环 # 继承 # public # 委托 # 泛型 # 对象 # typeof # postgresql # 数据库 # 自定义 # 最多 # 再用 # 这是 # 也不 # 都有 # 序列化 # 切分

返回目录在线咨询

上一篇：iOS中自定义弹出pickerView效果(DEMO)
下一篇：如何查询网站制作商名单,如何查询网站是哪家公司做的？

您的项目需求