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

来源：这里教程网时间：2026-02-21 17:39:23 作者：

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')));<br>CREATE INDEX IX_Customer_addr_line1 ON Customer(addr_line1);
避免在
WHERE
中大量使用
JSON_EXTRACT
，尤其跨多行计算时性能陡降更新时优先用属性赋值（
c.Address.Line1 = "new"
），EF Core 自动生成局部修改语句，比整字段重设更安全、更高效

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