EF Core值转换器怎么用 EF Core Value Converters教程_技术教程

EF Core值转换器是自动类型转换工具，用于实体与数据库间无缝转换枚举、JSON、TimeSpan等类型；支持匿名函数或自定义类配置，推荐优先使用内置转换器并注意null处理、序列化选项及字段类型匹配。

EF Core 值转换器（Value Converters）本质是“自动翻译官”——它在实体属性值写入数据库前、或从数据库读出后，悄悄做一次类型转换，业务代码完全不用感知。用对了，能省掉大量手动序列化/解析逻辑，还能让数据库字段更友好（比如存枚举为字符串、存对象为 JSON）。

什么时候该用值转换器？

常见场景包括：

把 enum 存成字符串（避免数据库里全是 0/1/2，难懂又难查）
把 List 或复杂对象序列化为 JSON 字符串（尤其适合轻量级配置、标签、地址等非关系型结构）
把 TimeSpan 转成 long（Ticks） 存整数，规避 SQL Server 对 TimeSpan 的精度限制
把 IPAddress、DateTimeOffset、Guid 等类型转成可存储的字符串或数字
做简单脱敏，比如 手机号入库前加密、读出后解密（注意：敏感操作建议用数据库层加密或专用安全库）

两种配置方式：一行代码 or 可复用类

推荐按使用频率选：

临时用、只配一次 → 直接在 OnModelCreating 里用 .HasConversion() 匿名函数
多处用、要测试、需统一行为 → 封装成继承 ValueConverter 的类

例如，给枚举配字符串转换：

// 方式一：匿名函数（简洁直接）

modelBuilder.Entity()
  .Property(e => e.Status)
  .HasConversion(v => v.ToString(), v => Enum.Parse(v));

// 方式二：独立类（便于复用和单元测试）

public class OrderStatusConverter : ValueConverter
{
  public OrderStatusConverter() : base(
    v => v.ToString(),
    v => (OrderStatus)Enum.Parse(typeof(OrderStatus), v)) { }
}

然后注册：.HasConversion()

JSON 类型转换要注意什么？

这是高频需求，但容易踩坑：

数据库字段类型得是 TEXT（SQLite）、nvarchar(max)（SQL Server）、json（PostgreSQL） 等支持长文本的类型
别用 JsonSerializerOptions.Default 直接传参——它默认忽略 null，可能丢失字段；建议显式配置：new JsonSerializerOptions { PropertyNamingPolicy = JsonNamingPolicy.CamelCase, DefaultIgnoreCondition = JsonIgnoreCondition.Never }
反序列化时若 JSON 格式错误，会抛 JsonException，EF Core 不捕获——务必确保数据干净，或加一层 try/catch 包装（放在自定义转换器内部）
不要对大对象（如 >1MB）频繁用 JSON 转换，性能和可维护性都会下降