Dapper不支持全自动深度嵌套映射，但可通过Multi-Mapping（如Query配合splitOn）实现一对一级联；一对多用QueryMultiple分步查询+内存关联；三层及以上需组合多步查询并手动组装，核心是显式控制、避免N+1、注意别名与空值处理。
Dapper 本身不支持全自动的深度嵌套对象映射（比如 User 包含 Address，Address 又包含 City），但通过组合使用 Query 的多映射（Multi-Mapping）和手动组装逻辑，完全可以优雅地实现嵌套对象填充。
用 Query 做两级关联映射
这是最常用、最清晰的方式，适用于主从结构（如 Order → OrderItem，User → Profile）。关键在于 SQL 中用 JOIN 拉平数据，并用 splitOn 参数告诉 Dapper 从哪一列开始是第二个对象的字段。
示例：映射 User 及其关联的 Department
var sql = @"
SELECT u.Id, u.Name, u.Email,
d.Id as DeptId, d.Name as DeptName, d.Code
FROM Users u
LEFT JOIN Departments d ON u.DeptId = d.Id";
var users = connection.Query(
sql,
(user, dept) =>
{
user.Department = dept; // 手动赋值
return user;
},
splitOn: "DeptId"
).ToList();
-
splitOn 必须匹配第二对象的第一个非空列名（这里用
d.Id as DeptId，所以写 "DeptId"）
- 两个对象字段名可以不同，但别名要和 C# 属性名一致（或开启
SqlMapper.AddTypeMap 自定义映射）
- lambda 中返回的是最终结果类型（这里是
User），可在此完成任意组装逻辑
处理一对多（如 User → List）：用 QueryMultiple 分步查询
一对多不能靠单条 JOIN 搞定（会产生笛卡尔积），推荐用 QueryMultiple 执行多个语句，再在内存中关联。
var sql = @"
SELECT * FROM Users WHERE IsActive = 1;
SELECT u.Id as UserId, p.* FROM Posts p
INNER JOIN Users u ON p.UserId = u.
Id
WHERE u.IsActive = 1;";
using var multi = connection.QueryMultiple(sql);
var users = multi.Read().ToList();
var posts = multi.Read().ToList();
// 手动按 UserId 分组挂载
var lookup = posts.GroupBy(p => p.UserId).ToDictionary(g => g.Key, g => g.ToList());
foreach (var user in users)
{
user.Posts = lookup.GetValueOrDefault(user.Id, new List());
}
- SQL 用分号分隔多个查询，Dapper 按顺序执行并返回多个结果集
- 先查主表，再查子表，避免重复加载和 N+1 问题
- 用
Dictionary> 做 O(1) 关联，比循环嵌套查找快得多
三层及以上嵌套（如 User → Department → Company）：组合 + 手动构建
没有内置三元映射，但可以拆解为两步：先用 Query 得到带 Department 的用户，再单独查 Company 并批量挂载。
// 第一步：查 User + Department（同上）
var usersWithDepts = connection.Query(...).ToList();
// 第二步：提取所有 DeptId，批量查 Company
var deptIds = usersWithDepts
.Where(u => u.Department != null)
.Select(u => u.Department.Id)
.Distinct()
.ToArray();
if (deptIds.Length > 0)
{
var companies = connection.Query(
"SELECT * FROM Companies WHERE Id IN @ids",
new { ids = deptIds }
).ToDictionary(c => c.Id);
foreach (var user in usersWithDepts)
{
if (user.Department != null && companies.TryGetValue(user.Department.Id, out var company))
{
user.Department.Company = company;
}
}}
- 避免为每个 Department 单独查 Company（N+1）
- 利用
ToDictionary 实现快速反查，保持线性时间复杂度
- 注意空值判断，防止 NullReferenceException
小技巧：用匿名对象或 ValueTuple 简化中间步骤
当嵌套层级多、临时组装频繁时，可用匿名类型过渡，让代码更松耦合：
var result = connection.Query(
sql,
(u, d, c) => (u, d, c),
splitOn: "DeptId,CompanyId"
).ToList();
// 再统一组装成最终对象
var finalUsers = result.Select(x =>
{
x.Item1.Department = x.Item2;
x.Item2.Company = x.Item3;
return x.Item1;
}).ToList();
- 适合一次性复杂映射，不想提前定义中间 DTO 类
- ValueTuple（C# 7+）比匿名类更轻量，且可序列化
- 仍需明确指定
splitOn 字段名，顺序必须与泛型参数一致
基本上就这些。Dapper 的哲学是“显式优于隐式”，它不隐藏 SQL 和映射逻辑，反而让你对性能和行为有完全掌控。嵌套映射不复杂，但容易忽略 splitOn 的大小写、别名一致性、空值处理这些细节。
# app
# ai
# c#
# sql
# int
# 循环
# Lambda
# 泛型
# 对象
# 多个
# 笛卡尔
# 不支持
# 的是
# 这是
# 字段名
# 让你
# 第一个
# 在此
# 适用于
相关文章：
如何快速搭建高效服务器建站系统？
免费网站制作appp,免费制作app哪个平台好？
如何挑选高效建站主机与优质域名？
宝塔建站助手安装配置与建站模板使用全流程解析
建站之星好吗？新手能否轻松上手建站？
制作网站建设的公司有哪些,网站建设比较好的公司都有哪些？
外贸公司网站制作,外贸网站建设一般有哪些步骤？
C#怎么创建控制台应用 C# Console App项目创建方法
如何在宝塔面板中创建新站点？
教育培训网站制作流程,请问edu教育网站的域名怎么申请？
专业企业网站设计制作公司,如何理解商贸企业的统一配送和分销网络建设？
如何选择适配移动端的WAP自助建站平台？
相册网站制作软件,图片上的网址怎么复制？
如何用腾讯建站主机快速创建免费网站？
常州企业网站制作公司,全国继续教育网怎么登录？
企业微网站怎么做,公司网站和公众号有什么区别？
定制建站策划方案_专业建站与网站建设方案一站式指南
利用JavaScript实现拖拽改变元素大小
小程序网站制作需要准备什么资料,如何制作小程序？
如何使用Golang安装API文档生成工具_快速生成接口文档
武汉网站如何制作,黄黄高铁武穴北站途经哪些村庄？
国美网站制作流程,国美电器蒸汽鍋怎么用官方网站？
简单实现Android文件上传
微信网站制作公司有哪些,民生银行办理公司开户怎么在微信网页上查询进度？
如何打造高效商业网站？建站目的决定转化率
建站之星收费标准详解：套餐费用及年费价格表一览
网站图片在线制作软件,怎么在图片上做链接？
Bpmn 2.0的XML文件怎么画流程图
网站视频制作书签怎么做,ie浏览器怎么将网站固定在书签工具栏？
如何在IIS中新建站点并配置端口与物理路径？
高性能网站服务器配置指南：安全稳定与高效建站核心方案
东莞专业网站制作公司有哪些,东莞招聘网站哪个好？
高防服务器租用如何选择配置与防御等级？
香港服务器网站卡顿？如何解决网络延迟与负载问题？
无锡营销型网站制作公司,无锡网选车牌流程？
如何在七牛云存储上搭建网站并设置自定义域名？
在线流程图制作网站手机版,谁能推荐几个好的CG原画资源网站么？
建站之星如何快速解决建站难题？
Python如何创建带属性的XML节点
建站VPS能否同时实现高效与安全翻墙？
如何在云指建站中生成FTP站点？
高防服务器如何保障网站安全无虞？
建站之星如何通过成品分离优化网站效率？
阿里云网站制作公司,阿里云快速搭建网站好用吗？
免费ppt制作网站,有没有值得推荐的免费PPT网站？
建站之星免费版是否永久可用？
建站之星官网登录失败？如何快速解决？
如何在Golang中使用replace替换模块_指定本地或远程路径
如何选择长沙网站建站模板？H5响应式与品牌定制哪个更优？
制作无缝贴图网站有哪些,3dmax无缝贴图怎么调？
Id
WHERE u.IsActive = 1;";
