EntityFramework Core 中 JSON 列查询的 Null 值处理问题分析

问题背景

在 EntityFramework Core 9.0 版本中，当使用 JSON 列特性处理嵌套对象时，如果内部嵌套类型允许为 Null，在特定查询场景下会出现异常。这个问题主要出现在以下情况：

1. 实体类中包含 JSON 列属性
2. JSON 列属性内部又包含可空的嵌套 JSON 列属性
3. 当这些可空属性实际值为 Null 时
4. 仅查询包含这些属性的 JSON 列时

问题重现

让我们通过一个典型的实体类设计来说明这个问题：

public class TTest
{
    public int Id { get; set; }
    public string Name { get; set; }
    
    [JsonColumn]
    public Config ConfInfo { get; set; }

    public class Config
    {
        public string AppName { get; set; }
        
        [JsonColumn]
        public WechatPayConf? WechatPay { get; set; }

        public class WechatPayConf
        {
            public string AppId { get; set; }
            public string MchId { get; set; }
        }
    }
}

在这个设计中，ConfInfo 是一个 JSON 列，而它内部的 WechatPay 属性也是一个 JSON 列，并且被标记为可空。

问题表现

当执行以下操作序列时会出现问题：

1. 创建一个新实体，其中 WechatPay 设为 null
2. 保存到数据库
3. 查询整个实体 - 工作正常
4. 仅查询 ConfInfo 列 - 抛出异常

异常信息表明 EF Core 无法正确处理 JSON 列中的 null 值。

技术分析

这个问题的本质在于 EF Core 9.0 对 JSON 列中嵌套可空类型的处理不够完善。具体来说：

1. 序列化问题：当 JSON 列中的嵌套属性为 null 时，EF Core 的序列化/反序列化逻辑存在缺陷
2. 查询投影问题：当仅查询包含嵌套 JSON 列的属性时，EF Core 生成的 SQL 查询和后续的对象映射逻辑无法正确处理 null 值
3. 配置缺失：EF Core 没有提供直接的方式来配置 JSON 序列化选项，如忽略 null 值

临时解决方案

在 EF Core 修复此问题前，开发者可以采用以下临时解决方案：

1. 避免嵌套 JSON 列中的 null 值：在保存前确保所有可空 JSON 属性都被初始化
2. 自定义序列化：通过自定义值转换器来控制 JSON 序列化行为
3. 完整实体查询：避免仅查询包含嵌套 JSON 列的属性

最佳实践建议

基于这个问题，我们建议在使用 EF Core 的 JSON 列特性时：

1. 谨慎设计嵌套的 JSON 结构，尽量减少多层嵌套
2. 对于可空属性，考虑在业务逻辑层处理默认值而非依赖数据库层
3. 在升级到新版本 EF Core 时，充分测试 JSON 列相关的查询场景
4. 考虑使用 DTO 投影而非直接查询实体属性，以获得更好的控制

总结

这个问题展示了 ORM 框架在处理复杂数据类型时可能遇到的边界情况。JSON 列作为现代数据库的重要特性，其与 ORM 的集成需要特别关注类型系统和 null 处理的细节。开发者在使用这些高级特性时，应当充分了解其限制，并建立适当的测试策略来确保数据访问层的稳定性。