LINQ表达式无法转换异常：根据RoleId列表查询角色求助

异常信息 #

System.InvalidOperationException: The LINQ expression '__ids_0
.Contains(StructuralTypeShaperExpression:
Patron.Domain.RoleAggregate.Role
ValueBufferExpression:
ProjectionBindingExpression: EmptyProjectionMember
IsNullable: False
.Id.Value)' could not be translated.

相关代码 #

报错的查询方法 #

public async Task<List<Role>> GetRolesByIdsAsync(List<RoleId> roleIds)
{
    var ids = roleIds.Select(id => id.Value).ToList();
    return await dbContext.Roles
        .Where(r => ids.Contains(r.Id.Value))
        .ToListAsync();
}

RoleId及基类定义 #

public sealed class RoleId : AggregateRootId<Guid>
{
    private RoleId(Guid value) : base(value)
    {
    }

    public static RoleId Create(Guid userId) =>
        new(userId);

    public static RoleId CreateUnique() =>
        new(Guid.NewGuid());

    public static ErrorOr<RoleId> Create(string value)
    {
        if (!Guid.TryParse(value, out var guid))
        {
            return Errors.Role.InvalidRoleId;
        }

        return new RoleId(guid);
    }
}

public abstract class AggregateRootId<TId> : EntityId<TId>
{
    protected AggregateRootId(TId value) : base(value)
    {
    }
}

public abstract class EntityId<TId>(TId value) : ValueObject
{
    public TId Value { get; } = value;

    public override IEnumerable<object?> GetEqualityComponents()
    {
        yield return Value;
    }

    public override string? ToString() => Value?.ToString() ?? 
        base.ToString();
}

低效的遍历方案 #

public async Task<List<Role>> GetListRoleByListId(List<RoleId> roleIds)
{
    var roles = new List<Role>();
    foreach (var role in await dbContext.Roles.ToListAsync())
    {
        foreach (var roleId in roleIds)
        {
            if (role.Id.Equals(roleId))
            {
                roles.Add(role);
            }
        }
    }

    return roles;
}

可正常执行的单个ID查询 #

public async Task<Role?> GetAsync(RoleId id) =>
    await dbContext.Roles.FirstOrDefaultAsync(r => r.Id == id);

异常原因 #

EF Core无法将r.Id.Value的深层属性访问逻辑正确翻译为SQL。单个RoleId比较能正常工作，是因为EF Core能识别值对象的相等比较并映射到对应数据库字段；但当结合Contains访问值对象内部的Value属性时，EF Core无法解析该属性对应的数据库列映射，最终导致翻译失败。

修复方案 #

推荐两种高效的修复方式：

方案一：直接使用RoleId集合进行Contains查询 #

利用EF Core对值对象相等比较的原生支持，直接传入RoleId集合而非提取内部Value：

public async Task<List<Role>> GetRolesByIdsAsync(List<RoleId> roleIds)
{
    return await dbContext.Roles
        .Where(r => roleIds.Contains(r.Id))
        .ToListAsync();
}

原理：EF Core会自动将值对象的Contains比较翻译为数据库的IN查询，符合DDD值对象的使用规范。

方案二：显式配置EF Core值对象属性映射 #

如果必须使用Value属性访问，可在EF Core实体配置中显式映射Role.Id.Value到数据库列：

// 在Role的EntityTypeConfiguration类中添加配置
builder.Property(r => r.Id.Value)
       .HasColumnName("Id") // 对应数据库主键列名
       .IsRequired();

配置完成后原查询代码即可正常执行，但方案一更简洁合规。

补充说明 #

• 务必避免使用遍历全表的低效方案，该方案会加载所有角色数据到内存后再筛选，性能损耗极大。
• 单个ID查询能正常工作，是因为EF Core处理值对象的==运算符时，会自动转换为对内部值的比较逻辑，而Contains结合属性访问时无此自动解析能力。

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