17370845950

Dapper 将数据库 NULL 映射为 C# null，空字符串 '' 映射为 ""，二者语义、内存表现及业务逻辑均不同；推荐使用 string? 接收以安全处理两者，或在 SQL 中用 ISNULL/COALESCE 统一转换。

Dapper 默认将数据库中的 NULL 映射为 C# 的 null（引用类型），而空字符串 '' 会映射为长度为 0 的 string 实例（即 ""）。二者在语义、内存表现和业务逻辑中完全不同，Dapper 不会自动“合并”或“转换”它们。

NULL → C# null，空字符串 → C# ""

这是 Dapper 最基础的映射行为，依赖 ADO.NET 的底层行为（如 DbDataReader.GetValue(i) 返回 DBNull.Value 或具体值）：

• 数据库字段值为 NULL → Dapper 给目标 string 属性赋值 null
• 数据库字段值为 ''（空字符串）→ Dapper 赋值 ""（非 null 的空字符串）
• 这个区分对可空引用类型（C# 8+）尤其明显：string? 可接收两者；string（不可为空）若映射到 NULL 会抛 InvalidOperationException

避免运行时异常：声明属性为 string? 或预处理 NULL

如果你的数据库字段允许 NULL，推荐用可空引用类型接收：

• 定义实体： public string? Name { get; set; }
• 这样 NULL 和 "" 都能安全映射，后续再按需判断：name == null（真 NULL）、string.IsNullOrEmpty(name)（含 NULL 和 ""）或 string.IsNullOrWhiteSpace(name)
• 如果必须用非空 string，可在 SQL 中统一处理，例如：ISNULL(Name, '') AS Name 或 COALESCE(Name, '')

自定义映射逻辑（如统一转空字符串）

若业务要求把数据库 NULL 全部视为空字符串，不改 SQL，可用 Dapper 的 SqlMapper.AddTypeHandler：

• 注册一个 TypeHandler，在 Parse 方法中把 DBNull.Value 转成 ""
• 注意：该 handler 会影响所有 string 映射，慎用于混合场景（比如有些字段要保留 NULL 语义）
• 更轻量的做法是查询后用 LINQ 投影转换：.Select(x => new { x.Id, Name = x.Name ?? "" })

验证与调试技巧

遇到映射不符合预期时，快速确认实际值类型：

• 在调试器中查看变量的“值”和“类型”，注意区分 null 和 ""
• 打印 obj.Name is null、string.IsNullOrEmpty(obj.Name)、object.Equals(obj.Name, DBNull.Value)（后者通常不成立，因 Dapper 已转为 null）
• 用 SQL Server Profiler 或 EF Core 日志确认返回结果集里字段真实值是 NULL 还是 ''

基本上就这些。核心就一条：Dapper 忠实反映数据库原始值，不擅自做语义转换。空字符串和 NULL 的区别不是 Dapper 的“问题”，而是你建模和处理时必须面对的事实。