C#怎么创建GraphQL接口_C# HotChocolate GraphQL开发教程【高级】-C#.Net教程-PHP中文网

hotchocolate服务注册必须在addcontrollers之前，否则graphql端点404；query字段不可见主因是可见性或命名不规范；iqueryable需显式启用addprojections()；端点需通过mapgraphql()挂载中间件。

c#怎么创建graphql接口_c# hotchocolate graphql开发教程【高级】

HotChocolate服务注册必须在AddControllers之前

GraphQL端点被404不是因为路径写错，而是中间件注册顺序错了。HotChocolate依赖自己的路由系统，如果AddControllers()先注册，它会接管所有未匹配的路径，把/graphql也拦下来。

正确顺序（.NET 6+ Program.cs）：

services.AddGraphQLServer()
    .AddQueryType<query>()
    .AddMutationType<mutation>();
// 必须放在这行之前
services.AddControllers();</mutation></query>

若用 EF Core，AddDbContext<appdbcontext>()</appdbcontext>也要在AddGraphQLServer()之前——类型发现阶段会扫描已注册的上下文
别在Configure里调AddGraphQLServer()，它是服务注册方法，不是中间件配置
不注册AddControllers()也能跑GraphQL，但混用Controller和GraphQL时顺序就关键了

Query类型字段不可见的常见原因

前端报Cannot query field "name" on type "Query"，90%是字段没被HotChocolate识别。它默认只暴露public实例属性，且不自动转换方法名。

错误写法示例：

C函数速查手册（CHM版）

下载

public class Query
{
    private string _name = "test";        // private → 不可见
    internal int Count => 42;            // internal → 不可见
    public string GetName() => _name;    // 方法 → 被转成"getname"，非标准字段名
}

属性优先：用public string Name { get; } = "test";代替GetName()
方法要可用，得返回值、无参数（或仅IResolverContext），并加[GraphQLName("name")]
ID参数必须标记[ID]，否则解析失败报Unable to infer GraphQL type

IQueryable返回值必须启用投影

直接返回IQueryable<user></user>看似方便，但默认不会生成SQL级过滤，而是把全表拉到内存再筛选——性能灾难。

启用服务端投影只需一行：

services.AddGraphQLServer()
    .AddQueryType<query>()
    .AddProjections(); // ← 关键！不加这句，IQueryable = IEnumerable</query>

AddProjections()让HotChocolate把GraphQL字段选择、where、skip/take等翻译成Expression Tree，最终生成SQL
只对IQueryable生效；IEnumerable或List<t></t>仍走内存处理
若用EF Core，确保实体属性有public getter，否则投影表达式编译失败

GraphQL端点404不是配置漏了，是中间件没挂载

注册了AddGraphQLServer() ≠ 端点可用。它只是注入服务，真正暴露HTTP入口靠中间件。

必须在app.UseRouting()之后、app.UseEndpoints()里显式挂载：

app.UseRouting();
app.UseAuthentication();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
    endpoints.MapGraphQL(); // ← 没这行，/graphql永远404
});