EF Core 7中JSON列怎么映射和查询

EF Core 7新增了对JSON列的原生支持，开发者可以直接将实体中的复杂属性映射到数据库的JSON列，无需手动序列化反序列化，同时还能直接对JSON列内部的内容进行查询，大幅简化了相关开发工作。

JSON列映射配置

要实现JSON列映射，首先需要在实体类中定义需要存储为JSON的属性，然后在DbContext中通过Fluent API进行配置。

实体类定义

假设我们有一个用户实体，用户有一个地址信息属性，地址包含省、市、街道等字段，我们希望将地址存储为JSON列。

// 地址类，作为嵌套复杂类型
public class Address
{
    public string Province { get; set; }
    public string City { get; set; }
    public string Street { get; set; }
}

// 用户实体
public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 需要映射为JSON列的地址属性
    public Address Address { get; set; }
}

DbContext配置

在DbContext的OnModelCreating方法中，使用OwnsOne方法配置地址属性，并指定使用JSON列存储。

public class AppDbContext : DbContext
{
    public DbSet<User> Users { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 配置User实体的Address属性
        modelBuilder.Entity<User>()
            .OwnsOne(u => u.Address, address =>
            {
                // 指定Address属性映射为JSON列
                address.ToJson();
                // 可以配置JSON列的名称，默认是属性名Address
                address.Property(a => a.Province).HasColumnName("address_province");
            });
    }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 这里使用SQL Server示例，其他数据库配置类似
        optionsBuilder.UseSqlServer("Server=localhost;Database=TestDb;Trusted_Connection=True;");
    }
}

配置完成后，执行数据库迁移，User表会生成一个名为Address的JSON列，存储Address对象的所有属性内容。

JSON列查询操作

EF Core 7支持直接对JSON列内部的内容进行查询，无需先取出整个JSON再处理，查询会直接转换为数据库的原生JSON查询语句，性能更好。

筛选JSON内部字段

比如我们需要查询所有地址在北京市的用户，可以直接在查询条件中访问JSON内部的City属性。

using var dbContext = new AppDbContext();
// 查询地址城市为北京的用户
var beijingUsers = dbContext.Users
    .Where(u => u.Address.City == "北京")
    .ToList();

提取JSON属性值

如果只需要获取JSON列中的某个属性值，可以使用Select直接投影出对应字段。

using var dbContext = new AppDbContext();
// 获取所有用户的地址省份
var provinces = dbContext.Users
    .Select(u => u.Address.Province)
    .ToList();

复杂JSON查询

对于更复杂的JSON查询场景，比如判断JSON数组是否包含某个值，或者查询JSON内部字段满足多个条件的情况，EF Core 7也支持对应的写法。

using var dbContext = new AppDbContext();
// 查询地址省份为河北且城市为石家庄的用户
var targetUsers = dbContext.Users
    .Where(u => u.Address.Province == "河北" && u.Address.City == "石家庄")
    .ToList();

注意事项

• JSON列映射目前支持SQL Server、PostgreSQL等主流数据库，不同数据库的JSON函数支持有差异，生成的具体SQL会有所不同。
• 如果修改了JSON列对应的复杂类型的结构，需要重新生成数据库迁移，确保JSON列的存储结构和实体定义一致。
• 查询JSON列时，EF Core会自动处理属性到JSON路径的映射，开发者不需要手动编写JSON路径表达式。

EF CoreJSON列映射JSON列查询Entity_Framework_Core修改时间：2026-07-15 15:03:24