hotchocolate 中需显式定义可查询类型并正确注册resolver：用objecttype或属性标记暴露public getter字段，避免ef实体直传；resolver须为实例方法、di注册、异步await、用reporterror而非throw。
HotChocolate 是目前 C# 生态中成熟度最高、文档最清晰的 GraphQL 服务端库，它不依赖 ASP.NET Core 的 MVC 模式，而是基于 Schema-first 或 Code-first 灵活构建；但新手常卡在类型映射和查询解析上，不是字段不返回，就是 NullReferenceException 在 resolver 中静默发生。
HotChocolate 中怎么定义可被 GraphQL 查询的类型
你不能直接把 EF Core 实体扔进 AddGraphQLServer() 就完事——HotChocolate 默认不会自动映射所有属性，尤其忽略 private set、只读集合、导航属性或未标注的复杂嵌套类型。
- 用
[GraphQLDescription]或[GraphQLName]显式控制字段名和说明，避免大小写或下划线导致客户端查询失败 - 对需要暴露的属性，必须确保有 public getter；若字段是
IEnumerable<t></t>，推荐显式声明为IList<t></t>或ReadOnlyCollection<t></t>，否则 HotChocolate 可能跳过该字段 - 避免在类型定义中直接引用
DbContext或IServiceProvider；类型类应保持无状态，数据获取逻辑统一交给 resolver - 如果使用 Code-first，推荐继承
ObjectType<t></t>并重写Configure方法，比纯属性标记更可控
Resolver 怎么写才不会丢数据或抛 NullReference
Resolver 是 HotChocolate 数据注入的入口，但它不自动执行依赖注入解析——比如你在 resolver 方法参数里写 IDataLoader<int user> loader</int>，却没提前注册 DataLoader，运行时就直接返回 null，且无明确错误提示。
- resolver 方法必须是实例方法（不能是 static），且所在类需通过
AddScoped注册到 DI 容器 - 参数中使用
IBinder、IDataLoader、IResolverContext等上下文对象前，先确认它们已在Program.cs中完成注册，例如：services.AddDataLoaderRegistry() - 对异步数据源（如 EF Core 的
ToListAsync()），resolver 必须声明为Task<t></t>返回值，并用await；返回Task.FromResult(...)是安全的，但返回未 await 的 Task 可能导致响应挂起 - 不要在 resolver 中 throw 业务异常（如
ArgumentException）；改用context.ReportError(...)，否则整个查询会中断并返回空 data
为什么 Query 类型里加了字段，GraphQL Playground 却查不到
常见原因是 Schema 构建阶段没真正“挂载”该字段，或者命名冲突导致被覆盖——HotChocolate 对重复注册极其敏感，哪怕只是大小写不同（如 User 和 user），也会静默忽略后者。
- 检查是否误用了
ISchemaBuilder手动拼接 schema；推荐全程走AddGraphQLServer().AddQueryType<query>()</query>链式注册 - Query 类本身必须是 public，且至少有一个 public 方法或属性；方法名默认转为 camelCase 字段名（
GetUsers→users），可通过[GraphQLName("users")]覆盖 - 如果字段返回的是自定义类型（如
UserDto），必须显式调用AddType<userdto>()</userdto>，否则该字段在 SDL（Schema Definition Language）中不会生成对应 type 声明 - 启动后访问
/graphql自动打开 Playground，点右上角「Schema」标签页，搜索字段名确认是否出现在 Query type 下；没出现就说明注册链断了
最容易被忽略的是 resolver 的生命周期绑定：HotChocolate 默认按请求作用域解析 resolver 实例，但如果 resolver 类里缓存了非线程安全的对象（比如手动 new 的 HttpClient），在并发查询下可能引发状态污染。别图省事把数据加载逻辑塞进构造函数——它只在 resolver 实例创建时执行一次，而非每次查询。
