EntityFramework.Docs 项目中的 JSON ID 包含根鉴别器变更说明

在 Entity Framework Core 的最新版本中，开发团队引入了一个重要的变更，涉及 JSON 列映射中实体 ID 的生成方式。这一变更主要影响使用 JSON 列存储继承层次结构的场景。

变更背景

在 Entity Framework Core 处理继承映射时，系统会为每个实体类型生成一个鉴别器值(discriminator)来区分不同的子类型。当这些实体被映射到 JSON 列时，EF Core 需要确保能够正确识别和重建对象图。

变更内容

最新版本中，EF Core 修改了 JSON 列中实体 ID 的生成策略。现在，当实体作为 JSON 文档的根对象存储时，其 ID 值将包含根类型的鉴别器信息。这一变更确保了即使在复杂的继承场景下，EF Core 也能正确识别和重建对象。

技术细节

在之前的实现中，JSON 文档中的实体 ID 可能不包含根类型的鉴别器信息，这可能导致在某些继承场景下出现识别问题。新的实现确保了：

1. 根实体类型的鉴别器信息被包含在 ID 中
2. 对象图的完整性得到更好的保证
3. 序列化和反序列化过程更加可靠

影响范围

这一变更主要影响以下场景：

• 使用 JSON 列存储继承层次结构的应用
• 依赖 JSON 列中实体 ID 格式的自定义逻辑
• 需要与存储的 JSON 数据进行直接交互的应用

迁移建议

对于现有应用，如果升级到包含此变更的版本，可能需要：

1. 检查应用中是否有直接依赖 JSON ID 格式的逻辑
2. 更新任何自定义的序列化/反序列化代码
3. 验证数据迁移脚本，确保与新的 ID 格式兼容

最佳实践

为了平滑过渡到新版本，建议开发人员：

1. 在测试环境中充分验证变更影响
2. 逐步迁移生产环境，避免一次性全量升级
3. 考虑实现兼容层来处理新旧两种 ID 格式

这一变更是 EF Core 持续改进 JSON 支持的一部分，旨在提供更强大和可靠的 ORM 功能。开发团队建议用户关注官方文档中的更新说明，以获取最新的使用指南和最佳实践。