HotChocolate如何通过投影实现数据库实体到DTO转换且避免过度查询

Hot Chocolate 原生支持跨模型的投影映射，不需要依赖AutoMapper即可实现仅拉取请求所需字段，完全避免过度查询，以下是两种常用实现方式：

方案1：通过特性直接标记映射关系（适合简单场景） #

直接在你的返回类型SimplePersonData上通过[MapFrom]特性标记每个字段对应的EF实体属性路径：

using HotChocolate.Data;

public class SimplePersonData
{
    [MapFrom(typeof(Person), nameof(Person.FirstName))]
    public string First { get; set; }
    
    [MapFrom(typeof(Person), nameof(Person.LastName))]
    public string Last { get; set; }
    
    [MapFrom(typeof(Person), nameof(Person.HomeAddress) + "." + nameof(Address.City))]
    public string HomeTown { get; set; }
}

然后调整你的Query解析器，直接返回IQueryable<Person>并添加[UseProjection]特性即可：

public class Query
{
    [UseProjection]
    public IQueryable<SimplePersonData> GetSimplePerson([Service] DbContext dbContext, int id)
    {
        return dbContext.People
            .Where(p => p.Id == id)
            .ProjectTo<SimplePersonData>();
    }
}

注意：此处的ProjectTo是HotChocolate.Data.Projection命名空间下的扩展方法，不是AutoMapper的同名方法。使用前需要在服务注册时开启投影功能：builder.Services.AddGraphQLServer().AddProjection()

方案2：通过ObjectType配置映射（适合复杂映射场景） #

如果你的映射逻辑比较复杂，或者不想在DTO类上加额外特性，可以通过自定义ObjectType来统一配置映射规则：

using HotChocolate.Types;
using HotChocolate.Data;

public class SimplePersonDataType : ObjectType<SimplePersonData>
{
    protected override void Configure(IObjectTypeDescriptor<SimplePersonData> descriptor)
    {
        descriptor.Field(x => x.First)
            .MapFrom<Person>(p => p.FirstName);
        
        descriptor.Field(x => x.Last)
            .MapFrom<Person>(p => p.LastName);
        
        descriptor.Field(x => x.HomeTown)
            .MapFrom<Person>(p => p.HomeAddress.City);
    }
}

然后在服务注册时添加这个类型配置即可：

builder.Services.AddGraphQLServer()
    .AddType<SimplePersonDataType>()
    .AddProjection()
    .AddFiltering()
    .AddSorting();

Query解析器的写法和方案1完全一致。

实现原理 #

Hot Chocolate的投影引擎会读取你配置的MapFrom规则，结合当前GraphQL请求的字段列表，动态生成EF查询的Select表达式：

• 如果请求不包含homeTown字段，生成的SQL不会关联Address表，也不会查询任何Address相关字段
• 如果仅请求first字段，生成的SQL只会查询FirstName一列，完全没有多余数据拉取
• 关联表的查询也是按需加载，不会提前Include所有关联实体

这种方式完美匹配领域Schema和数据库Schema不一致的场景，同时保留了Hot Chocolate原生投影的所有性能优势。

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