如何使用Dapper的splitOn将关联查询结果映射到嵌套DTO？

核心原理：splitOn参数的作用 #

splitOn用于告诉Dapper，结果集中从哪个列开始属于下一个要映射的对象。对于三层嵌套的DTO结构，我们需要指定两个分割点：分割ClassA与ClassB的列，以及分割ClassB与ClassC的列。

步骤1：优化SQL查询（可选但推荐） #

你的SQL已经按「ClassA字段→ClassB字段→ClassC字段」的顺序返回列，只需移除DTO中无对应属性的冗余字段（比如原SQL中的DField1），减少不必要的数据传输：

SELECT
    [a].[a_field_1] AS 'AField1',
    [a].[a_field_2] AS 'AField2',
    [a].[a_field_3] AS 'AField3',
    [b].[b_field_1] AS 'BField1',
    [b].[b_field_2] AS 'BField2',
    [c].[c_field_1] AS 'CField1',
    [c].[c_field_2] AS 'CField2'
FROM
    [dbo].[Table_A] AS [a]
LEFT JOIN
    [dbo].[Table_B] AS [b] ON [a].[table_a_id] = [b].[a_id]
LEFT JOIN
    [dbo].[Table_C] AS [c] ON [b].[table_b_id] = [c].[b_id]
LEFT JOIN
    [dbo].[Table_D] AS [d] ON [c].[table_c_id] = [d].[c_id]
LEFT JOIN
    [dbo].[Table_E] AS [e] ON [d].[table_d_id] = [e].[d_id]

步骤2：设置正确的splitOn参数 #

指定第二个对象（ClassB）的第一个列名BField1，以及第三个对象（ClassC）的第一个列名CField1，用逗号分隔即可。

步骤3：修正后的完整代码实现 #

var query = await sqlConnection.QueryAsync<ClassA, ClassB, ClassC>(
    SqlStatementHelper.ReadSqlStatementFile(SqlStatementFileNames.MyQuery),
    (classA, classB, classC) =>
    {
        // 处理LEFT JOIN导致的空对象场景：若B字段全为null，直接设为null而非空实例
        if (string.IsNullOrEmpty(classB.BField1) && string.IsNullOrEmpty(classB.BField2))
        {
            classA.ClassB = null;
        }
        else
        {
            classA.ClassB = classB;
            // 同理处理C的空值情况
            if (string.IsNullOrEmpty(classC.CField1) && string.IsNullOrEmpty(classC.CField2))
            {
                classB.ClassC = null;
            }
            else
            {
                classB.ClassC = classC;
            }
        }
        return classA;
    },
    splitOn: "BField1,CField1");

关键注意事项 #

• 列顺序严格匹配：SQL返回的列必须按照「ClassA所有字段→ClassB所有字段→ClassC所有字段」的顺序排列，否则Dapper会映射错误。
• 空值处理：LEFT JOIN可能导致无匹配数据，此时Dapper会创建空属性的对象实例而非null，若需要嵌套对象为null，需在映射委托中添加判断逻辑。
• 避免冗余字段：不要返回DTO中未定义的字段，避免干扰映射逻辑和浪费资源。

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