Dapper多表映射下，如何用LINQ按ID、邮箱、电话关联键正确分组

多表联查产生笛卡尔积时，单个员工的所有关联电话、邮箱条目会被按行数重复匹配，不管在分组前、分组过程中、分组后做手动遍历赋值，只要没有对重复的子表条目做基于主键的去重，就一定会出现集合内重复数据、甚至嵌套结构错乱的问题。之前尝试直接遍历收集邮箱再赋值的逻辑失效，本质是没有跳过重复行里的相同邮箱条目，把每一行带的重复邮箱都塞到了临时集合里。

1. 对齐SQL字段顺序与Dapper拆分规则 #

联查SQL的输出字段必须严格按照「主实体字段 -> 各从表字段 -> 关联字典表字段」的顺序排列，不能跨表混排。参考字段顺序：

• 第一块：Employees表全部字段（EmployeeId、员工姓名等）
• 第二块：Emails表全部字段（EmailId、邮箱地址等，作为第一个拆分节点）
• 第三块：Phones表全部字段（PhoneId、手机号等，作为第二个拆分节点）
• 第四块：JobTitles、Departments、EmployeeStatus表的关联字典字段

对应Dapper查询的splitOn参数，按拆分的每个从表的首字段名配置即可，比如splitOn: "EmailId,PhoneId,JobTitleId"。

注意：如果字段顺序和splitOn不匹配，会导致Dapper拆分对象时把上一个表的字段映射到下一个实体上，这是很多映射逻辑失效的隐性原因。

2. 用LINQ分组做带主键去重的集合归集 #

不要依赖Dapper内置的多类型映射直接生成嵌套对象，先通过拆分映射拿到每一行的基础对象元组，再按员工ID分组处理：

// 先获取每行拆分后的基础对象，不直接组装最终实体
var rawQueryRows = await dbConnection.QueryAsync<
    EmployeeModel, 
    EmailModel, 
    PhoneModel, 
    (EmployeeModel Emp, EmailModel Mail, PhoneModel Phone, RelatedInfo Info)
>(
    sql:联查SQL语句,
    map: (emp, mail, phone, info) => (emp, mail, phone, info),
    splitOn: "EmailId,PhoneId,JobTitleId"
);

// 核心分组逻辑
var finalEmployeeList = rawQueryRows
    .GroupBy(row => row.Emp.EmployeeId) // 以员工唯一主键为分组键
    .Select(employeeGroup => {
        // 取分组内第一条的员工基础信息（所有行的员工单值属性完全一致）
        var currentEmployee = employeeGroup.First().Emp;
        // 赋值单值类的关联字典属性
        currentEmployee.JobTitle = employeeGroup.First().Info.JobTitle;
        currentEmployee.Department = employeeGroup.First().Info.Department;
        currentEmployee.EmployeeStatus = employeeGroup.First().Info.EmployeeStatus;

        // 归集不重复的邮箱集合：过滤拆分空值，按邮箱主键去重
        currentEmployee.EmailList = employeeGroup
            .Select(row => row.Mail)
            .Where(mail => mail != null && mail.EmailId != default) // 过滤无邮箱时拆出的空值
            .GroupBy(mail => mail.EmailId) // 按邮箱主键去重，避免笛卡尔积带来的重复条目
            .Select(mailGroup => mailGroup.First())
            .ToList();
        
        // 归集不重复的电话集合：和邮箱逻辑完全一致
        currentEmployee.PhoneList = employeeGroup
            .Select(row => row.Phone)
            .Where(phone => phone != null && phone.PhoneId != default)
            .GroupBy(phone => phone.PhoneId)
            .Select(phoneGroup => phoneGroup.First())
            .ToList();

        return currentEmployee;
    })
    .ToList();

3. 常见踩坑提醒 #

• 子表去重必须按子表的数据库主键ID判断，不能按字段值去重：不同员工可能存在相同的手机号、邮箱地址，按值去重会误删正常关联数据
• 必须加上拆分空值判断：当某个员工没有关联的电话/邮箱时，Dapper拆分出来的对应子表对象是null，不做过滤会把空值塞进集合里
• 不要在分组前手动遍历临时列表构建集合：临时列表里的每条行记录都带着笛卡尔积带来的重复子表条目，手动遍历会把重复值反复追加到集合中，达不到去重效果

内容的提问来源于stack exchange，提问作者Joshua White