jsonb 为什么会影响 System.Text.Json
内容提要
在将属性映射到 jsonb 类型时，System.Text.Json 要求类型鉴别器（$type）必须是第一个属性，否则会抛出异常。由于 jsonb 存储会自动排序属性，建议将 JsonSerializerOptions 的 AllowOutOfOrderMetadataProperties 属性设置为 true 以解决此问题。
关键要点
-
在将属性映射到 jsonb 类型时，$type 必须是第一个属性，否则会抛出异常。
-
使用 [JsonDerivedType] 时，System.Text.Json 要求类型鉴别器必须在 json 中的首位。
-
jsonb 类型会自动对 json 属性进行排序，导致存储后的属性顺序与序列化时不同。
-
解决方案是将 JsonSerializerOptions 的 AllowOutOfOrderMetadataProperties 属性设置为 true。
-
如果找不到该属性，建议升级到高版本。
延伸解读
类型鉴别器的重要性
在使用 System.Text.Json 进行多态反序列化时，类型鉴别器（$type）必须位于 JSON 的首位。这一要求是为了确保反序列化过程的顺利进行，若不满足此条件，将导致异常抛出。开发者在设计 JSON 结构时需特别注意这一点，以避免不必要的错误。
jsonb 与 json 的区别
jsonb 类型在 PostgreSQL 中以二进制形式存储数据，自动对 JSON 属性进行排序和规范化。这意味着在存储过程中，属性的顺序可能会发生变化，导致与原始序列化时的顺序不一致。了解这一点对于数据持久化和后续处理至关重要。
解决方案与版本要求
为了解决类型鉴别器顺序问题，建议将 JsonSerializerOptions 的 AllowOutOfOrderMetadataProperties 属性设置为 true。如果在使用中未找到该属性，可能需要升级到更高版本的库。这一操作可以有效避免反序列化时的异常，确保数据处理的稳定性。
延伸问答
为什么在使用 System.Text.Json 时，$type 必须是第一个属性？
因为 System.Text.Json 要求类型鉴别器必须在 json 中的首位，否则会抛出异常。
如何解决 jsonb 类型导致的反序列化异常？
可以通过将 JsonSerializerOptions 的 AllowOutOfOrderMetadataProperties 属性设置为 true 来解决此问题。
json 和 jsonb 在存储上有什么区别？
json 以原始文本形式存储，而 jsonb 以二进制形式存储，会解析和规范化 json 数据。
如果找不到 AllowOutOfOrderMetadataProperties 属性该怎么办？
建议升级到高版本以获取该属性。
System.Text.Json 的多态反序列化有什么限制？
多态反序列化要求类型鉴别器必须是 json 中的第一个属性，否则会导致反序列化失败。
jsonb 类型如何影响属性的顺序？
jsonb 类型会自动对 json 属性进行排序，导致存储后的属性顺序与序列化时不同。
