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<string></string>,在
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 的“问题”,而是你建模和处理时必须面对的事实。
