如何在EF Core中避免代码重复同时限制查询返回列？

问题背景 #

我们有一个包含大字段的实体类，以及仅保留必要字段的DTO：

public record VeryBigObject(int Id, string Name, string LotsOfData);
public record VeryBigObjectDto(int Id, string Name);

业务中极少需要LotsOfData字段，希望查询时只返回DTO需要的列以减少数据传输，但面临两难：

• 直接在Select中手动创建DTO（如示例中的FindById1），SQL仅查询必要列，但多方法需重复编写映射代码，字段较多时代码冗余严重。
• 用静态方法封装映射（如示例中的FindById2），复用了代码，但EF会查询所有列（包括LotsOfData），造成冗余传输。

可行解决方案 #

1. 使用表达式树封装映射逻辑 #

EF Core能够解析表达式树并转换为对应的SQL投影，因此可以将映射逻辑定义为静态表达式，替代普通方法：

// 集中管理映射逻辑的类
public static class VeryBigObjectMap
{
    public static readonly Expression<Func<VeryBigObject, VeryBigObjectDto>> ToDto = 
        entity => new VeryBigObjectDto(entity.Id, entity.Name);
}

在服务中复用该表达式：

public async Task<VeryBigObjectDto> FindById(int id)
{
    return await context.VeryBigObjects
        .Where(o => o.Id == id)
        .Select(VeryBigObjectMap.ToDto)
        .FirstOrDefaultAsync();
}

效果：生成的SQL仅查询Id和Name列，映射逻辑只编写一次，可在所有需要的地方复用。

2. 利用AutoMapper的ProjectTo方法 #

AutoMapper支持与EF Core集成，通过ProjectTo方法直接将查询投影为DTO，同时EF会自动生成仅包含必要字段的SQL：

首先配置AutoMapper映射：

public class MappingProfile : Profile
{
    public MappingProfile()
    {
        CreateMap<VeryBigObject, VeryBigObjectDto>();
    }
}

在服务中使用：

public async Task<VeryBigObjectDto> FindById(int id, IMapper mapper)
{
    return await context.VeryBigObjects
        .Where(o => o.Id == id)
        .ProjectTo<VeryBigObjectDto>(mapper.ConfigurationProvider)
        .FirstOrDefaultAsync();
}

优势：适合复杂映射场景（如嵌套DTO、多实体关联映射），自动处理字段匹配，大幅减少手动映射代码。

3. 封装查询扩展方法 #

将投影逻辑封装为IQueryable的扩展方法，实现复用：

public static class VeryBigObjectQueryExtensions
{
    public static IQueryable<VeryBigObjectDto> AsDto(this IQueryable<VeryBigObject> query)
    {
        return query.Select(o => new VeryBigObjectDto(o.Id, o.Name));
    }
}

服务中调用扩展方法：

public async Task<VeryBigObjectDto> FindById(int id)
{
    return await context.VeryBigObjects
        .Where(o => o.Id == id)
        .AsDto()
        .FirstOrDefaultAsync();
}

特点：轻量无依赖，逻辑直观，适合简单映射场景，维护成本低。

总结 #

以上三种方案均能同时满足：

• 限制EF Core仅查询DTO所需字段，避免冗余数据传输
• 映射逻辑仅定义一次，在多个服务或方法中复用，消除代码重复

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