EF Core 中编译模型时 IsPrimitiveCollection 元数据错误问题解析

在使用 EF Core 8.0 及以上版本时，开发者可能会遇到一个关于集合类型元数据标记的潜在问题。这个问题主要出现在使用编译模型（compiled model）功能时，会导致实体中定义的原始类型集合（primitive collection）属性在运行时被错误识别。

问题现象

当开发者定义一个包含原始类型集合（如字符串数组）的实体属性时，EF Core 通常会正确地将该属性标记为 IsPrimitiveCollection=true。例如：

public class Article
{
    public string Id { get; set; } = null!;
    public string[] Tags { get; set; } = [];
}

在常规运行时模型中，EF Core 能够正确识别 Tags 属性是一个原始类型集合。然而，当使用编译模型功能时，这个标记会被错误地设置为 false，导致后续的 LINQ 查询（如 Any() 操作）无法正常工作。

问题影响

这个错误会导致以下具体问题：

1. 使用编译模型时，针对原始类型集合的 LINQ 查询会失败
2. 数据库迁移可能无法正确生成对应的表结构
3. 序列化和反序列化行为可能出现不一致

技术背景

EF Core 8.0 引入了对原始类型集合的更好支持，允许开发者直接在实体中使用基本类型的数组或列表。这些集合会被映射到数据库中的 JSON 列或单独的表，具体取决于数据库提供程序。

IsPrimitiveCollection 标记是 EF Core 内部用来区分以下两种集合类型的关键元数据：

1. 原始类型集合：如 string[], List 等
2. 导航属性集合：如 ICollection 等

这个标记的正确性对于 EF Core 生成适当的 SQL 查询至关重要。

临时解决方案

在官方修复发布前，开发者可以通过以下方式临时解决这个问题：

partial class ArticleEntityType
{
    static partial void Customize(RuntimeEntityType runtimeEntityType)
    {
        var tagsProperty = runtimeEntityType.FindProperty(nameof(Article.Tags));
        if (tagsProperty != null)
        {
            tagsProperty.SetElementType(
                typeof(string),
                typeMapping: tagsProperty.TypeMapping.ElementTypeMapping,
                primitiveCollection: true);
        }
    }
}

这段代码手动修正了编译模型中 Tags 属性的元数据，确保其被正确识别为原始类型集合。

最佳实践建议

1. 在使用编译模型功能时，特别注意检查原始类型集合属性的行为
2. 考虑在单元测试中添加对 IsPrimitiveCollection 标记的验证
3. 对于关键业务场景，暂时避免混合使用编译模型和原始类型集合功能

问题修复状态

该问题已被 EF Core 团队确认并标记为需要修复。开发者可以关注 EF Core 的后续版本更新，特别是补丁版本发布说明，以获取官方修复信息。

对于生产环境中的关键应用，建议评估该问题对系统的影响程度，并根据情况选择等待官方修复或采用上述临时解决方案。