使用Dapper映射嵌套对象失败问题求助

我之前也碰到过类似的Dapper嵌套映射问题，大概率是没正确告诉Dapper如何拆分结果集或者列名匹配出了问题，给你几个关键的排查和解决步骤：

1. 确认存储过程的查询列名与实体属性匹配 #

首先检查你的存储过程返回的结果集，必须确保嵌套对象（比如Reason）的列名和实体类的属性名对应，或者用别名明确区分。比如如果你的Reason类有Id和Description属性，存储过程的查询应该类似这样：

SELECT 
    dn.DocumentNavID,
    dn.NavName,
    r.Id AS ReasonId, -- 用别名和主对象列区分
    r.Description AS ReasonDescription
FROM PA.DocumentNav dn
LEFT JOIN PA.Reason r ON dn.ReasonId = r.Id
WHERE dn.DocumentNavID = @DocumentNavID

这样Dapper才能识别哪些列属于主对象，哪些属于嵌套的Reason对象。

2. 调用Dapper时指定SplitOn参数 #

这是最容易遗漏的关键点！Dapper默认不知道从哪一列开始拆分嵌套对象，你需要在Query/QuerySingleOrDefault方法里指定SplitOn参数，告诉它拆分的分界列。

假设你的实体类是这样的：

public class DocumentNav
{
    public int DocumentNavID { get; set; }
    public string NavName { get; set; }
    public Reason Reason { get; set; }
}

public class Reason
{
    public int ReasonId { get; set; }
    public string ReasonDescription { get; set; }
}

那么调用Dapper的代码应该改成：

using(var connection = new SqlConnection(yourConnectionString))
{
    var nav = connection.QuerySingleOrDefault<DocumentNav, Reason, DocumentNav>(
        "PA.spGetDocumentNavById",
        (documentNav, reason) => 
        {
            documentNav.Reason = reason; // 这里如果reason为null，说明左连接没匹配到，属于正常情况；如果应该有数据却为null，就是映射问题
            return documentNav;
        },
        param: new { DocumentNavID = yourDocumentNavId },
        commandType: CommandType.StoredProcedure,
        splitOn: "ReasonId" // 指定嵌套对象的起始列名，也就是结果集中第一个属于Reason的列
    );
}

SplitOn的值要和你存储过程返回的结果集中，第一个属于嵌套对象的列名完全一致（大小写敏感，取决于数据库配置）。

3. 排查左连接导致的合法null #

如果你的存储过程用了LEFT JOIN关联Reason表，那么当没有匹配的记录时，reason变量自然会是null，这属于正常业务场景，不是Dapper的问题。但如果确认应该有匹配的记录却返回null，那就要回到前两步检查列名和SplitOn参数。

4. 复杂场景的自定义映射（可选） #

如果你的嵌套结构更复杂（比如多层嵌套），可以用Dapper的自定义类型映射，但对于简单的一对一嵌套，前面的方法完全足够。

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