使用Dapper在ASP.Net Core中多表映射单对象无数据返回问题

嘿，我来帮你捋捋这个问题！你遇到的是Dapper处理多表关联（尤其是多对多中间表）映射嵌套对象时的常见坑，咱一步步来排查和解决：

1. 先确认SQL查询本身是否有效 #

很多时候映射失败的根源是SQL没返回数据，先把你写的关联SQL单独拿出来在数据库工具里执行，看看有没有结果。比如针对你的表结构，正确的关联查询应该类似这样（注意用LEFT JOIN避免无关联记录时丢失用户数据，同时给重复字段加别名）：

SELECT 
    u.Id AS UserId, u.Name,
    a.Id AS AddressId, a.Street,
    at.Id AS AddressTypeId, at.TypeName,
    p.Id AS PhoneId, p.Number,
    pt.Id AS PhoneTypeId, pt.TypeName
FROM [user] u
LEFT JOIN user_has_address uha ON u.Id = uha.user_id
LEFT JOIN address a ON uha.address_id = a.Id
LEFT JOIN address_type at ON a.address_type_id = at.Id -- 假设address表关联address_type的字段是address_type_id
LEFT JOIN user_has_phone uhp ON u.Id = uhp.user_id -- 你提到phone_number没存user_id，应该也有类似的中间表
LEFT JOIN phone_number p ON uhp.phone_id = p.Id
LEFT JOIN phone_number_type pt ON p.phone_type_id = pt.Id
WHERE u.Id = @UserId

如果这条SQL本身没返回数据，那Dapper肯定也拿不到结果，先把SQL调通再说。

2. 确保实体类结构符合映射要求 #

你的实体需要包含嵌套的集合对象，比如：

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public List<Address> Addresses { get; set; }
    public List<PhoneNumber> PhoneNumbers { get; set; }
}

public class Address
{
    public int Id { get; set; }
    public string Street { get; set; }
    public AddressType Type { get; set; }
}

public class AddressType
{
    public int Id { get; set; }
    public string TypeName { get; set; }
}

// PhoneNumber和PhoneNumberType结构类似
public class PhoneNumber
{
    public int Id { get; set; }
    public string Number { get; set; }
    public PhoneNumberType Type { get; set; }
}

public class PhoneNumberType
{
    public int Id { get; set; }
    public string TypeName { get; set; }
}

3. 用Dapper的分组映射处理一对多关系 #

Dapper默认的Query方法适合一对一映射，而你的场景是一个用户对应多个地址/电话，需要手动分组避免重复创建对象，代码示例如下：

var userDict = new Dictionary<int, User>();

var sql = "-- 这里放你调试好的SQL语句";

var result = connection.Query<User, Address, AddressType, PhoneNumber, PhoneNumberType, User>(
    sql,
    (user, address, addressType, phone, phoneType) =>
    {
        // 复用同一个User对象，避免SQL笛卡尔积导致重复创建
        if (!userDict.TryGetValue(user.Id, out var currentUser))
        {
            currentUser = user;
            currentUser.Addresses = new List<Address>();
            currentUser.PhoneNumbers = new List<PhoneNumber>();
            userDict.Add(currentUser.Id, currentUser);
        }

        // 处理地址（LEFT JOIN可能返回null，要判断）
        if (address != null)
        {
            address.Type = addressType;
            // 避免重复添加同一个地址
            if (!currentUser.Addresses.Any(a => a.Id == address.Id))
            {
                currentUser.Addresses.Add(address);
            }
        }

        // 处理电话号码，逻辑和地址一致
        if (phone != null)
        {
            phone.Type = phoneType;
            if (!currentUser.PhoneNumbers.Any(p => p.Id == phone.Id))
            {
                currentUser.PhoneNumbers.Add(phone);
            }
        }

        return currentUser;
    },
    param: new { UserId = 1 }, // 替换成你要查询的用户ID
    splitOn: "AddressId,AddressTypeId,PhoneId,PhoneTypeId" // 告诉Dapper拆分实体的字段
).Distinct().ToList();

var targetUser = result.FirstOrDefault();

4. 常见错误点排查 #

• 误用INNER JOIN：如果用户没有地址/电话，INNER JOIN会直接过滤掉该用户记录，必须用LEFT JOIN。
• 字段名冲突：多个表的Id、Name等字段如果不加别名，Dapper会映射混乱，比如把Address的Id赋值给User的Id。
• splitOn参数错误：这个参数指定了Dapper拆分不同实体的分界字段，顺序要和你映射的实体顺序对应，字段名要和SQL里的别名一致。
• 未处理重复子对象：SQL返回的是笛卡尔积（用户+地址+电话的组合），同一个地址/电话会重复出现，必须通过Id判断去重。

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