EF Core枚举集合映射后LINQ查询翻译失败问题求助

问题场景 #

我将ICollection<GeneticModificationTypes>枚举集合通过EF Core映射为数据库的Varchar列，存储格式为逗号分隔的枚举名称字符串（例如"SomeType,AnotherType"）。但执行关联LINQ查询时，EF Core无法将集合操作翻译成SQL，抛出异常。

模型定义 #

public enum GeneticModificationTypes
{
    SomeType = 1,
    AnotherType = 2,
    ThirdType = 3
}

public class GeneticModification: FullAuditedEntity<Guid>
{
   public ICollection<GeneticModificationTypes> Types { get; set; } 
}

EF Core配置 #

modelBuilder.Entity<GeneticModification>()
        .Property(e => e.Types)
        .HasConversion(
            v => string.Join(',', v),
            v => v.Split(',', StringSplitOptions.RemoveEmptyEntries)
                  .Select(s => Enum.Parse<GeneticModificationTypes>(s))
                  .ToList() ?? new List<GeneticModificationTypes>())
        .Metadata.SetValueComparer(valueComparer);

// 修正原代码中ValueComparer类型不匹配的问题
var valueComparer = new ValueComparer<ICollection<GeneticModificationTypes>>(
                    (c1, c2) => c1.SequenceEqual(c2),
                    c => c.Aggregate(0, (a, v) => HashCode.Combine(a, v.GetHashCode())),
                    c => (ICollection<GeneticModificationTypes>)c.ToHashSet());

待执行的LINQ查询 #

// 查询包含任意目标枚举类型的记录
_context.GeneticModification.Where(r => r.Types.Any(b => listOfTypes.Contains(b))) 

抛出的异常 #

System.InvalidOperationException : The LINQ expression 'DbSet<GeneticModification>()
    .Where(m => m.OrganizationId == __organizationId_0)
    .OrderBy(m => m.CreationTime)
    .Skip(__p_1)
    .Take(__p_2)
    .Where(m => m.GeneticModificationTypes
        .Contains(__filters_GeneticModificationTypes_Value_3))' could not be translated. Additional information: Translation of method 'System.Linq.Enumerable.Contains' failed. Either rewrite the query in a form that can be translated, or switch to client evaluation explicitly by inserting a call to 'AsEnumerable', 'AsAsyncEnumerable', 'ToList', or 'ToListAsync'.

问题根源 #

EF Core无法将ICollection<T>.Contains/Any这类集合操作翻译成针对逗号分隔字符串列的SQL，因为数据库中存储的是单一字符串值，而非原生集合类型。当前的Value Converter仅负责读写时的格式转换，不提供查询翻译支持。

解决方案 #

方案1：构造字符串匹配查询（服务器端评估，推荐） #

直接针对数据库中存储的逗号分隔字符串构造匹配条件，避免集合操作，让EF Core能正常翻译成SQL，同时避免部分匹配的问题。

// 将目标枚举列表转为对应的名称字符串
var targetTypeNames = listOfTypes.Select(t => t.ToString()).ToList();

// 构造边界匹配条件
var result = _context.GeneticModification
    .Where(gm => targetTypeNames.Any(typeName => 
        // 匹配唯一值
        EF.Property<string>(gm, "Types") == typeName ||
        // 匹配开头的类型
        EF.Property<string>(gm, "Types").StartsWith(typeName + ",") ||
        // 匹配结尾的类型
        EF.Property<string>(gm, "Types").EndsWith("," + typeName) ||
        // 匹配中间的类型
        EF.Property<string>(gm, "Types").Contains("," + typeName + ",")
    ))
    .ToList();

方案2：客户端评估（小数据量场景） #

如果表数据量较小，可以先将所有记录加载到内存，再在客户端执行过滤。注意：数据量大时会严重影响性能。

var result = _context.GeneticModification
    .AsEnumerable() // 切换到客户端评估
    .Where(r => r.Types.Any(b => listOfTypes.Contains(b)))
    .ToList();

方案3：改用JSON列存储（长期最优方案） #

EF Core 5.0及以上支持将集合映射为JSON列，原生支持集合操作的查询翻译，无需手动处理字符串匹配。

修改EF Core配置：

using System.Text.Json;

modelBuilder.Entity<GeneticModification>()
    .Property(e => e.Types)
    .HasConversion(
        v => JsonSerializer.Serialize(v, null),
        v => JsonSerializer.Deserialize<List<GeneticModificationTypes>>(v, null)
    )
    .HasColumnType("json"); // 对应数据库类型，例如SQL Server用NVARCHAR(MAX)或JSON类型

配置完成后，原有的LINQ查询即可直接正常执行，EF Core会自动翻译成对应的JSON查询SQL。

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