Dapper多表查询结果合并问题解析与解决方案

概述

在使用Dapper进行多表查询时，开发者经常会遇到一个常见问题：当查询结果包含一对多关系时，返回的结果集可能无法正确合并关联数据。本文将深入分析这个问题，并提供有效的解决方案。

问题现象

当使用Dapper的QueryAsync方法执行包含多个LEFT JOIN的查询时，即使数据库返回了多条关联记录，最终结果中只会包含第一条匹配的关联数据。这种现象在查询一对多关系时尤为明显。

问题原因分析

Dapper的多表映射机制默认情况下不会自动合并相同主表的关联数据。当查询结果包含多条记录时，Dapper会为每条记录创建一个新的主表对象实例，即使这些记录对应的是同一个主表实体。

在示例代码中，每次调用映射函数时，都会创建一个新的DocumentDto实例，之前添加的标签和协作者信息不会保留到下一次映射中。这导致了最终结果中只包含最后一次映射的关联数据。

解决方案

1. 使用分组合并技术

通过LINQ的分组功能，我们可以手动合并关联数据：

var documents = await connection.QueryAsync<DocumentDto, LabelDto, CollaboratorDto, DocumentDto>(
    GetDocumentSql,
    (doc, label, collaborator) => {
        if (label is not null && label.LabelId != Guid.Empty)
        {
            doc.Labels.Add(label);
        }
        if (collaborator.ProfileId != Guid.Empty)
        {
            doc.Collaborators.Add(collaborator);
        }
        return doc;
    }, 
    new { Id = documentId.ToString() },
    splitOn: "LabelId,DocumentId");

var result = documents
    .GroupBy(d => d.Id)
    .Select(g =>
    {
        var groupedDocument = g.First();
        groupedDocument.Labels = g.Select(d => d.Labels.Single())
            .GroupBy(l => l.LabelId)
            .Select(l => l.First())
            .ToList();
        groupedDocument.Collaborators = g.Select(d => d.Collaborators.Single())
            .GroupBy(c => c.ProfileId)
            .Select(c => c.First())
            .ToList();
        return groupedDocument;
    });

2. 解决方案解析

1. 初始查询：执行多表查询，为每条数据库记录创建包含关联数据的DocumentDto对象
2. 按主键分组：使用GroupBy按文档ID分组，确保同一文档的所有记录被合并
3. 合并关联数据：
   • 提取每个文档实例中的标签和协作者数据
   • 再次按关联实体的主键分组去重
   • 合并到第一个文档实例中

3. 优化建议

虽然上述解决方案有效，但代码略显冗长。可以考虑以下优化：

1. 创建扩展方法简化合并逻辑
2. 对于大型结果集，考虑使用字典缓存来优化性能
3. 在可能的情况下，考虑使用Dapper的MultiMapping功能

总结

Dapper作为轻量级ORM工具，在处理复杂关系时需要开发者手动处理关联数据的合并。理解Dapper的工作机制后，我们可以通过合理的LINQ操作实现完整的数据合并。这种解决方案虽然需要额外代码，但提供了对合并过程的完全控制，适用于各种复杂场景。

对于性能敏感的应用，建议对合并逻辑进行基准测试，并根据实际数据特点选择最优的实现方式。