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

多表查询结果合并的挑战

在使用Dapper进行数据库操作时，开发人员经常会遇到需要从多个关联表中获取数据并合并到一个对象中的场景。本文以一个文档管理系统为例，展示了如何解决Dapper多表查询结果合并时只返回第一条匹配记录的问题。

问题背景

在文档管理系统中，我们需要查询一个文档的详细信息，包括文档本身的信息、关联的标签以及协作者信息。通过SQL查询可以轻松获取这些数据，但使用Dapper的QueryAsync方法进行映射时，发现最终返回的对象只包含了第一条匹配记录，而后续记录中的关联数据没有被正确合并。

数据模型分析

系统包含以下几个核心数据模型：

1. 文档模型(DocumentDto)：存储文档的基本信息，如ID、名称、描述等
2. 标签模型(LabelDto)：表示文档的分类标签
3. 协作者模型(CollaboratorDto)：记录可以访问该文档的用户及其权限

原始解决方案的问题

最初使用Dapper的QueryAsync方法进行多表映射时，虽然映射函数会被正确调用多次，但每次调用都是独立处理的，导致前一次调用中对文档对象的修改（如添加标签或协作者）在下一次调用中无法保留。

优化后的解决方案

通过分析Dapper的工作原理，我们采用了分组聚合的方式来合并查询结果：

1. 首先执行原始查询，获取所有行数据
2. 按照文档ID进行分组
3. 对每个分组：
   • 取第一个文档对象作为基础
   • 从所有行中提取标签信息，去重后合并
   • 从所有行中提取协作者信息，去重后合并

实现代码解析

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;
    });

技术要点说明

1. Dapper的多映射查询：使用QueryAsync方法可以一次性映射多个对象类型
2. 结果分组处理：通过LINQ的GroupBy方法对查询结果进行分组
3. 数据合并策略：
   • 对于标签数据，按照LabelId进行去重
   • 对于协作者数据，按照ProfileId进行去重
4. 空值处理：通过检查Guid.Empty来过滤掉空记录

性能考量

虽然这种解决方案需要额外的内存处理，但对于中小规模的数据集来说性能影响可以接受。对于大数据量的场景，可以考虑以下优化：

1. 在数据库层面进行部分聚合
2. 使用更高效的数据结构进行内存处理
3. 考虑分批处理大量数据

总结

Dapper作为轻量级ORM工具，在处理复杂关联查询时需要开发人员手动处理结果合并。通过本文介绍的分组聚合方法，可以有效地解决多表查询结果合并的问题，同时保持代码的清晰性和可维护性。这种模式不仅适用于文档管理系统，也可以推广到其他需要处理一对多关系的业务场景中。