Dapper如何处理数据库的空字符串和NULL C# string映射区别

来源:这里教程网 时间:2026-02-21 17:37:38 作者:

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

相关推荐