EF Core中ICollection<string>的ValueComparer引发参数类型不匹配错误

问题背景 #

按照微软官方《Collection of Primitives》示例，实现Attachment实体的Tags属性转换配置，相关代码如下：

转换配置代码 #

public class AttachmentTagsConfiguration : IEntityTypeConfiguration<Attachment>
{
    public void Configure(EntityTypeBuilder<Attachment> builder)
    {
        builder.Property(e => e.Tags).HasConversion(
            v => string.Join( ' ', v.Select(x => x.ToLower()).Distinct() ),
            v => v.Split( ' ', StringSplitOptions.RemoveEmptyEntries )
                .Select( x => x.ToLower() )
                .Distinct()
                .ToList(),
            new ValueComparer<ICollection<string>>(
                (c1, c2) => c1.SequenceEqual(c2),
                c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
                c => c.ToList()
            )
        );
    }
}

Attachment实体定义 #

public class Attachment
{
    // 其他属性...

    public ICollection<string> Tags { get; set; }
}

报错现象 #

保留ValueComparer时，加载包含Attachment的查询会抛出错误：

System.ArgumentException: 'Argument types do not match'

移除ValueComparer则运行正常，但担心变更追踪无法正常工作。已知数据库中Tags字段无NULL值，Attachment是父类，存在AssetAttachments等多个子类，疑惑子类是否会影响SequenceEqual比较。

错误原因 #

核心问题是EF Core处理继承体系时，传入ValueComparer的集合类型与声明的ICollection<string>不匹配：

• EF Core加载子类实例时，可能将Tags实例化为具体集合类型（如HashSet<string>或内部代理集合），而非声明的接口类型，导致ValueComparer的泛型参数与实际传入类型不符，触发参数类型错误。
• 转换逻辑返回List<string>，但实体属性声明为ICollection<string>，EF Core追踪时可能赋值其他集合类型，进一步加剧类型不匹配。

解决方案 #

调整ValueComparer泛型参数为具体类型 #

将ValueComparer的泛型参数改为转换逻辑返回的List<string>，确保类型匹配：

new ValueComparer<List<string>>(
    (c1, c2) => c1.SequenceEqual(c2),
    c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
    c => c.ToList()
)

修改实体属性为具体集合类型 #

将Attachment的Tags属性声明改为List<string>，消除接口与具体实现的类型差异：

public class Attachment
{
    // 其他属性...

    public List<string> Tags { get; set; } = new List<string>();
}

补充说明 #

• 子类继承Attachment后，只要Tags属性类型保持一致，不会影响SequenceEqual比较——比较的是集合元素的序列与值，与子类类型无关。
• 保留ValueComparer才能确保EF Core正确识别Tags集合的内容变化，避免不必要的数据库更新。

内容的提问来源于stack exchange，提问作者Mitkins