DDD仓储中值对象类型的Contains查询配置问题及报错排查

问题背景 #

在DDD架构的项目中，Student实体包含StudentName值对象类型的Name字段：使用HasConversion映射后无法通过x.Name.Value.Contains(...)进行查询；切换为OwnsOne配置后，又出现EF Core无法绑定实体构造函数参数的错误。

方案1：利用隐式转换，保留HasConversion配置（推荐单属性值对象） #

操作步骤 #

1. 保持原有的HasConversion配置不变：

public class StudentConfig : IEntityTypeConfiguration<Student>
{
    private readonly int studentNameMaxLen = 300;

    public void Configure(EntityTypeBuilder<Student> builder)
    {
        builder.Property(x => x.Name)
               .HasConversion(b => b.Value, b => StudentName.GetInstance(b))
               .IsRequired()
               .HasMaxLength(studentNameMaxLen);
    }
}

2. 修改查询语句，借助StudentName的隐式转换特性，避免直接访问Value属性：

public async Task<ListResponse<IList<GetStudentsDto>>> GetStudents(GetStudentsQuery param)
{
    var query = _repository.AsQueryable();
    
    // 利用隐式转换将StudentName转为string，EF Core会解析为数据库字段的LIKE查询
    query = query.Where(x => ((string)x.Name).Contains(param.Name));
    
    var result = await query.ToList<Student, GetStudentsDto>(_mapper, param);
    return result;
}

原理 #

HasConversion已将StudentName映射为数据库中的string字段，EF Core可将(string)x.Name.Contains(...)解析为对该字段的LIKE查询，既实现Contains功能，又无需修改实体结构。

方案2：使用OwnsOne并修复构造函数绑定问题（适合多属性值对象） #

操作步骤 #

1. 给Student实体添加受保护的无参构造函数，供EF Core内部实例化使用，保留原有的领域构造函数：

public class Student : LongBaseAggregateRoot
{
    public StudentName Name { get; protected set; }

    // 领域层使用的构造函数
    public Student(StudentName name)
    {
        Name = name;
    }

    // EF Core专用的受保护无参构造函数，不对外暴露
    protected Student() { }
}

2. 配置OwnsOne并添加字段长度限制：

public class StudentConfig : IEntityTypeConfiguration<Student>
{
    private readonly int studentNameMaxLen = 300;

    public void Configure(EntityTypeBuilder<Student> builder)
    {
        builder.OwnsOne(x => x.Name)
               .Property(x => x.Value)
               .HasColumnName(nameof(Student.Name))
               .IsRequired()
               .HasMaxLength(studentNameMaxLen);
    }
}

3. 原查询语句可正常使用：

query = query.Where(x => x.Name.Value.Contains(param.Name));

原理 #

EF Core使用OwnsOne时会将Name视为导航属性，无法绑定到构造函数的StudentName参数。添加受保护无参构造函数后，EF Core可直接实例化实体并设置属性，同时不破坏领域层的封装规则。

关键注意事项 #

• 互斥配置：HasConversion与OwnsOne不可同时使用，前者用于将值对象转换为数据库原生类型，后者用于将值对象作为拥有实体映射。
• 方案选择：单属性值对象优先选方案1，配置更简洁；多属性复杂值对象选方案2，扩展性更强。

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