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

畫卷琴夢 2026-01-24 00:00:00 次阅读

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 VARCHAR(256) STORED AS (JSON_UNQUOTE(JSON_EXTRACT(Address, '$.Line1')));
CREATE INDEX IX_Customer_addr_line1 ON Customer(addr_line1);