Dapper+PostgreSQL查询返回默认GUID而非真实ID的问题排查

以下是针对问题的常见原因分析及对应修复方案：

1. SQL查询字段映射或遗漏问题 #

• 问题点：若SQL未显式返回Appointment的id字段，或返回的列名与实体类Id属性不匹配，Dapper无法正确映射真实ID。
• 修复：
  • 确保SQL中包含a.id（假设表别名是a），建议显式指定字段别名以匹配实体属性名，例如：

    SELECT a.id AS Id, a.patient_id AS PatientId, a.doctor_id AS DoctorId, p.*, d.*
    FROM appointments a
    JOIN patients p ON a.patient_id = p.id
    JOIN doctors d ON a.doctor_id = d.id
    WHERE a.id = @Id
    

  • 直接在PostgreSQL客户端执行SQL，验证返回的Id列是否为数据库中真实的GUID值，排除数据源问题。

2. splitOn参数配置错误 #

• 问题点：splitOn参数匹配的是SQL返回的列名（而非实体属性名），若配置的字段名与结果集列名不匹配，Dapper无法正确拆分关联实体，可能导致Appointment的属性映射异常。
• 修复：
  • 若SQL返回的关联实体起始列是patient_id和doctor_id，则splitOn需设置为对应的列名：

    var appointment = await _connection.QuerySingleOrDefaultAsync<Appointment, Patient, Doctor, Appointment>(
        sql,
        (appt, patient, doctor) => {
            appt.Patient = patient;
            appt.Doctor = doctor;
            return appt;
        },
        param: new { Id = id },
        splitOn: "patient_id,doctor_id");
    

  • 若使用字段别名（如Patient_Id），则splitOn需对应别名：splitOn: "Patient_Id,Doctor_Id"。

3. PostgreSQL GUID类型映射问题 #

• 问题点：Npgsql驱动未正确配置GUID与PostgreSQL uuid类型的映射，导致Dapper无法解析数据库返回的uuid值。
• 修复：
  • 在项目启动时添加Npgsql类型映射配置：

    NpgsqlConnection.GlobalTypeMapper.MapGuidType();
    

  • 确保实体类的Id属性为Guid类型，而非string或其他类型；同时确认数据库中对应字段为uuid类型，而非字符串存储。

4. 实体类属性定义冲突 #

• 问题点：若Appointment类重复定义了Id属性（覆盖基类Entity的Id），会导致Dapper映射逻辑混乱。
• 修复：
  • 检查Appointment类，移除重复的Id定义，直接使用基类Entity的Id属性：

    // 错误示例：重复定义Id
    public class Appointment : Entity
    {
        public new Guid Id { get; set; } // 需删除此行
        // ...其他属性
    }
    

5. 映射委托逻辑异常 #

• 问题点：若在Dapper的映射委托中意外重置了Appointment的Id值，会导致返回默认GUID。
• 修复：
  • 检查委托代码，确保未修改appt.Id：

    // 正确示例：仅关联实体赋值
    (appt, patient, doctor) => {
        appt.Patient = patient;
        appt.Doctor = doctor;
        return appt;
    }
    

额外排查技巧 #

• 使用QueryAsync<dynamic>执行SQL，查看返回的动态对象中Id字段的实际值，快速定位是SQL返回问题还是Dapper映射问题：

  var result = await _connection.QueryAsync<dynamic>(sql, new { Id = id });
  // 输出result[0].Id查看真实值
  

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