如何在Dapper中查询一对多关系并返回带图片列表的单个ImageGroup对象

现有SQL语句如下：

SELECT I.*, IG.Id 
FROM Images I 
JOIN ImageGroup IG ON I.ImageGroupId = IG.Id 
WHERE IG.Id = @imageGroupId

（假设ImageGroup除IG.Id外还有其他字段）
需要返回一个包含Id、其他字段及Images列表的ImageGroup对象，而非Dapper Query方法返回的IEnumerable<ImageGroup>，请问如何用Dapper实现这一需求的最优方案？

最优实现方案 #

Dapper的多映射（Multi-Mapping）配合字典分组是处理这类一对多关联的高效方案，具体步骤如下：

1. 定义匹配需求的实体类 #

先搭建好对应的数据结构，确保包含关联列表：

public class ImageGroup
{
    public int Id { get; set; }
    // ImageGroup的其他业务字段，示例字段仅供参考
    public string GroupName { get; set; }
    public DateTime CreateTime { get; set; }
    // 存储关联的图片列表
    public List<Image> Images { get; set; } = new List<Image>();
}

public class Image
{
    public int Id { get; set; }
    public int ImageGroupId { get; set; }
    // Image的其他业务字段，示例字段仅供参考
    public string ImageUrl { get; set; }
    public long FileSize { get; set; }
}

2. 优化SQL语句 #

为避免字段映射冲突，显式指定所有字段并给重复命名的字段加别名：

SELECT 
    IG.Id AS GroupId, IG.GroupName, IG.CreateTime,
    I.Id AS ImageId, I.ImageGroupId, I.ImageUrl, I.FileSize
FROM Images I 
JOIN ImageGroup IG ON I.ImageGroupId = IG.Id 
WHERE IG.Id = @imageGroupId

3. 执行多映射查询并聚合结果 #

利用Dapper的Query重载，结合字典去重并聚合关联列表：

using (var connection = new SqlConnection("你的数据库连接字符串"))
{
    var groupDict = new Dictionary<int, ImageGroup>();

    connection.Query<ImageGroup, Image, ImageGroup>(
        sql: "上述优化后的SQL语句",
        map: (group, image) =>
        {
            // 用ImageGroup的Id作为字典键，确保只创建一个实例
            if (!groupDict.TryGetValue(group.Id, out var currentGroup))
            {
                currentGroup = group;
                groupDict.Add(currentGroup.Id, currentGroup);
            }
            // 将当前图片添加到对应分组的列表中
            currentGroup.Images.Add(image);
            return currentGroup;
        },
        param: new { imageGroupId = 你的分组ID参数 },
        splitOn: "ImageId" // 指定字段分割点：之前的字段映射到ImageGroup，之后的映射到Image
    );

    // 从字典中取出最终的单个ImageGroup对象
    var targetGroup = groupDict.Values.FirstOrDefault();
}

方案说明 #

• 字典分组能避免重复创建ImageGroup实例，性能远优于后续内存去重。
• splitOn参数是核心：它明确告诉Dapper何时切换映射目标实体，必须对应SQL中第二个实体的首个字段别名。
• 显式指定SQL字段和别名，能彻底规避不同实体间字段名重复导致的映射错误。

内容的提问来源于stack exchange，提问作者Michael Trullas Garcia