我在将一个属性映射到 jsonb 类型时遇到这样一个问题 ------ 我有一个抽象基类 BaseClass 和一个派生类 DerivedClass：

复制代码

[JsonDerivedType(typeof(DerivedClass), typeDiscriminator: "derived")]
public class BaseClass
{
    public BaseClass() { }
}
public class DerivedClass : BaseClass
{
    ....
}

当持久化数据后，我可能得到这样的数据：

复制代码

{
  "$type": "derived",
  ...
}

或

复制代码

{
  "value": 131121,
  "$type": "derived",
  ...
}

第一个 json 中，类型鉴别器（$type）是 json 里的第一个属性；而第二个 json 字符串则不是这种情况。当我执行 Deserialize 方法时，第二个 json 字符串会抛出异常。

复制代码

System.Text.Json.JsonException : The metadata property is either not supported by the type or is not the first property in the deserialized JSON object. Path: $.$type | LineNumber: 0 | BytePositionInLine: 47.

问题原因

System.Text.Json 的多态反序列化限制

当使用 [JsonDerivedType] 时，System.Text.Json 要求类型鉴别器（如 $type）必须是 json 中的第一个属性。如果鉴别器不在首位，反序列化会失败并抛出异常。

PostgreSQL 的存储特性

- json：以原始文本形式存储，完全保留输入的 json 字符串格式（包括空格、重复键、顺序等）。

- jsonb：以二进制形式存储，会对 json 进行解析和规范化（例如去重键、忽略多余空格、重新排序键）。

jsonb 类型会自动对 json 属性进行排序，导致存储后的属性顺序与序列化时不同。例如：{" $type":"derived","value": xxx } 存储到 jsonb 后可能变为：{"value": xxx ,"$ type":"derived"} 这种顺序变化会引发 System.Text.Json 的异常。

解决方案

其实微软在官方文档中已经给出了说明：

通过设置 AllowOutOfOrderMetadataProperties 属性为 true，可解决此问题：

复制代码

JsonSerializerOptions options = new() { AllowOutOfOrderMetadataProperties = true };

如果您没有找到该属性，请升级到高版本。

jsonb 为什么会影响 System.Text.Json

问题原因

System.Text.Json 的多态反序列化限制

PostgreSQL 的存储特性

解决方案