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










