EntityFramework Core 8 中 JSON 列查询异常问题解析

问题背景

在使用 EntityFramework Core 8 配合 PostgreSQL 数据库时，开发人员遇到了一个关于 JSON 列查询的异常问题。当尝试查询包含 JSON 类型列的表时，系统会抛出 System.Text.Json.JsonReaderException 异常，提示"0x00"在单个 JSON 值后无效，预期应为数据结束。

问题重现

这个问题出现在以下场景中：

1. 数据库表结构包含 JSON/JSONB 类型的列
2. 表中存在三种类型的记录：
   • 关系型 NULL 值（数据库 NULL）
   • JSON 字面量 null 值（字符串"null"）
   • 有效的 JSON 对象（如{"CPU": "ARM"}）
3. 使用 EF Core 8 的数据库优先方法生成模型
4. 通过 OwnsOne 配置将 JSON 列映射到 C# 对象

技术分析

JSON 值的两种表示形式

在关系型数据库中，JSON 类型的列可以有两种方式表示 null 值：

1. 关系型 NULL：数据库列本身的 NULL 值
2. JSON null：列值为非 NULL 的字符串"null"（JSON 规范中的 null 字面量）

EF Core 的 JSON 映射机制

EF Core 8 引入了对 JSON 列的更好支持，特别是通过 OwnsOne 配置可以将 JSON 列映射到复杂类型。然而，当前实现存在以下限制：

1. 对于顶级 JSON 实体，EF Core 期望要么是一个 JSON 对象，要么是关系型 NULL
2. 当遇到 JSON 字面量 null 时，系统无法正确处理，导致 JSON 解析器异常

异常原因

异常的根本原因在于 EF Core 的 JSON 反序列化逻辑没有充分考虑所有合法的 JSON 值情况。特别是：

• 有效 JSON 不仅限于对象（{}），还包括数组（[]）、字面量（null, true, false, 数字等）
• 但在 EF 的上下文中，只有对象或关系型 NULL 才是有效的实体表示

解决方案与建议

临时解决方案

目前可用的临时解决方案包括：

1. 投影查询：通过 Select 投影需要的字段，然后在客户端组装实体

   var projection = await ctx.Products.AsNoTracking()
       .Select(x => new { x.Id, x.ConfigJSON })
       .ToListAsync();
   var products = projection.Select(x => new Product { Id = x.Id, ConfigJSON = x.ConfigJSON })
       .ToList();
   

   缺点：需要手动映射所有字段，且失去变更跟踪功能

2. 数据库清理：确保 JSON 列只包含有效对象或关系型 NULL，不存储 JSON 字面量 null

长期解决方案

等待 EF Core 团队修复此问题，预期修复方向可能包括：

1. 增强 JSON 反序列化逻辑，正确处理 JSON 字面量 null
2. 提供更明确的错误信息，指导开发者如何修正数据
3. 增加配置选项，指定如何处理非对象 JSON 值

最佳实践建议

1. 数据一致性：在数据库设计中，统一使用关系型 NULL 或 JSON null 中的一种表示方式
2. 数据验证：在应用层或数据库约束中确保 JSON 列只包含有效值
3. 版本选择：关注 EF Core 后续版本更新，及时升级获取修复

总结

这个问题展示了在使用 ORM 处理半结构化数据时的常见挑战。虽然 JSON 提供了灵活性，但在与强类型系统交互时需要明确的约定和边界。开发者在设计数据模型时应当考虑 ORM 框架的限制，并在灵活性和严格性之间找到平衡点。

对于生产环境中的关键应用，建议采用临时解决方案中的数据库清理方法，确保数据符合 EF Core 的预期格式，同时关注 EF Core 的更新以获取官方修复。