EF Core .Includes()搭配Automapper无法返回关联实体问题求助

问题场景 #

我定义了Company和Review实体类，以及仅保留客户端所需属性的CompanyResponse和ReviewResponse DTO类。在服务层通过仓库方法加载包含关联评论的公司实体后，使用AutoMapper映射到CompanyResponse时，仅返回了公司基础数据，关联的评论未被映射返回。

相关代码 #

DTO类

public class CompanyResponse {
    public int Id { get; set; }
    public string Name { get; set; }
    public string Description { get; set; }
    public string Industry { get; set; }
    public int Size { get; set; }
    public DateTime FoundedDate { get; set; }
    public StatusType StatusType { get; set; }
    public ICollection<CompanyReviewResponse> CompanyReviews { get; set; }
    public string CreatedBy { get; set; }
}

public class ReviewResponse {
    public string Title { get; set; }
    public string Message { get; set; }
    public Rating Rating { get; set; }
    public string Role { get; set; }
    public string Location { get; set; }
    public DateTime StartDate { get; set; }
    public DateTime EndDate { get; set; }
    [JsonIgnore]
    public int CompanyId { get; set; }
    public string CreatedBy { get; set; }
    public DateTime CreatedDate { get; set; }
}

初始AutoMapper配置

CreateMap<Company, CompanyResponse>().ReverseMap();
CreateMap<Review, ReviewResponse>().ReverseMap();

仓库层加载关联实体方法

public async Task<IReadOnlyList<T>> GetAllIncludingAsync(params Expression<Func<T, object>>[] includeProperties) {
    IQueryable<T> query = _context.Set<T>();

    foreach (var includeProperty in includeProperties) {
        query = query.Include(includeProperty);
    }

    return await query.ToListAsync();
}

服务层初始实现

public async Task<IEnumerable<CompanyResponse>> GetCompanies(bool doIncludeCompanyReviews = false) {
    var companies = await _repository.GetAllIncludingAsync(c => c.Reviews);
    var mappedCompaniesResponse = _mapper.Map<IEnumerable<CompanyResponse>>(companies);
    return mappedCompaniesResponse;
}

原因分析 #

1. 属性名称不匹配：Company实体的关联集合是Reviews，但CompanyResponse中的对应集合是CompanyReviews，AutoMapper默认无法自动匹配不同名称的集合属性。
2. 实体映射的局限性：先加载完整实体再映射的方式，即使通过Include加载了关联数据，若未显式配置集合映射规则，AutoMapper无法正确将Review实体集合转换为目标DTO集合。

解决方法 #

通过投影查询结合显式映射配置解决问题，具体步骤如下：

1. 更新AutoMapper映射配置 #

显式指定实体与DTO之间的集合属性映射规则，确保关联数据能正确转换：

CreateMap<Company, CompanyResponse>()
    .ForMember(dest => dest.CompanyReviews,
        opt => opt.MapFrom(src => src.Reviews))
    .ReverseMap();

CreateMap<Review, ReviewResponse>().ReverseMap();

2. 使用ProjectTo直接从数据库投影到DTO #

替换原有的实体加载+映射方式，使用AutoMapper的ProjectTo方法直接生成SQL查询，仅获取DTO所需字段，同时自动处理关联集合的投影：

public async Task<IEnumerable<CompanyResponse>> GetCompanies(bool doIncludeCompanyReviews = false) {
    var companies = _context.Company
        .ProjectTo<CompanyResponse>(_mapper.ConfigurationProvider);
    return await companies.ToListAsync();
}

说明 #

• ProjectTo方法会利用AutoMapper配置直接生成针对性的SQL语句，只查询DTO中定义的字段，避免加载不必要的数据，提升查询性能。
• 显式配置MapFrom解决了实体与DTO集合属性名称不匹配的问题，确保关联数据能被正确映射到DTO中。

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