EF Core JSON列怎么映射 EF Core 7 JSON列查询教程

EF Core 7 原生支持 JSON 列映射，推荐用 Owned Entity + ToJson() 方式声明和配置，支持 LINQ 点语法查询、局部更新及索引优化。

EF Core 7 原生支持 JSON 列映射，不用手动序列化/反序列化，也不用写自定义转换器——只要配置得当，就能像操作普通属性一样读写、查询、更新 JSON 字段。

实体类里怎么声明 JSON 字段

推荐用 Owned Entity + ToJson() 方式，语义清晰、结构可控。比如地址信息不单独建表，就存成一个 JSON 字段：

public class Customer
{
  public int Id { get; set; }
  public string Name { get; set; } = "";
  public Address Address { get; set; } = null!;
}

public class Address
{
  public string Line1 { get; set; } = "";
  public string Line2 { get; set; } = "";
}

DbContext 中怎么配置为 JSON 列

在 OnModelCreating 里启用 OwnsOne(...).ToJson()：

modelBuilder.Entity()
  .OwnsOne(e => e.Address, addressBuilder =>
  {
    addressBuilder.ToJson();
    addressBuilder.Property(a => a.Line1).HasMaxLength(256);
    addressBuilder.Property(a => a.Line2).HasMaxLength(256);
  });

• 数据库中只生成一个 Address TEXT 或 JSON 类型字段（MySQL/PostgreSQL 自动识别）
• EF Core 会自动用 JSON_MODIFY（SQL Server）或 JSON_SET（MySQL）做局部更新，不是整字段覆盖
• 嵌套多层也只需顶层调用 .ToJson()，子对象自动纳入

怎么查询 JSON 字段里的值

直接用点语法写 LINQ，EF Core 会翻译成原生 JSON 函数：

var customers = await context.Customers
  .Where(c => c.Address.Line1 == "Beijing Road")
  .ToListAsync();

• SQL Server → 翻译为 JSON_VALUE(Address, '$.Line1')
• MySQL → 翻译为 JSON_EXTRACT(Address, '$.Line1')
• 支持 Contains、StartsWith、OrderBy 等常见操作
• 如需模糊匹配或复杂条件，可用 EF.Functions.JsonValue 手动指定路径

性能优化关键点

JSON 查询快不快，不取决于 EF Core，而在于数据库是否能走索引：

• 对高频查询的 JSON 字段，在数据库建 生成列（Generated Column）+ 普通索引，例如 MySQL：
  

  ALTER TABLE Customer ADD COLUMN addr_line1 V
  ARCHAR(256) STORED AS (JSON_UNQUOTE(JSON_EXTRACT(Address, '$.Line1')));
  CREATE INDEX IX_Customer_addr_line1 ON Customer(addr_line1);

• 避免在 WHERE 中大量使用 JSON_EXTRACT，尤其跨多行计算时性能陡降
• 更新时优先用属性赋值（c.Address.Line1 = "new"），EF Core 自动生成局部修改语句，比整字段重设更安全、更高效

基本上就这些。配置一次，后续增删改查都和普通属性一样自然，不用碰 JSON 字符串。