C#如何实现GraphQL接口 HotChocolate GraphQL框架教程

用 HotChocolate 实现 GraphQL 接口需四步：1. 创建 ASP.NET Core 项目并安装 HotChocolate.AspNetCore 等包；2. 用代码优先方式定义 Object Type（如 BookType）；3. 编写 Query 类并注册为根查询类型；4. 在中间件中调用 MapGraphQL() 启用 /graphql 端点。

用 HotChocolate 实现 GraphQL 接口在 C# 中非常直观，核心是定义类型、编写解析器、注册服务并启用中间件。不需要手写 HTTP 路由或序列化逻辑，框架自动处理查询解析、字段执行和错误响应。

1. 创建基础项目并安装 HotChocolate

新建一个 ASP.NET Core Web API 项目（.NET 6+ 推荐），通过 NuGet 安装关键包：

HotChocolate.AspNetCore（提供服务器中间件）
HotChocolate.Types（用于定义 Schema 类型）
可选：HotChocolate.Data（简化 EF Core 集成）

安装命令示例：

dotnet add package HotChocolate.AspNetCore

2. 定义 GraphQL 类型（Object Type）

HotChocolate 支持代码优先（Code-First）方式。比如有一个 C# 模型：

public class Book { public Guid Id { get; set; } public string Title { get; set; } public string Author { get; set; } }

对应定义 GraphQL 类型：

public class BookType : ObjectType { protected override void Configure(IObjectTypeDescriptor descriptor) { descriptor.Field(x => x.Title).Description("书名"); descriptor.Field(x => x.Author).Description("作者"); } }

3. 编写 Query 类与解析器

创建一个普通类，用 [GraphQLName("Query")] 标记，并添加返回数据的方法：

public class Query { public IEnumerable GetBooks() => new[] { new Book { Id = Guid.NewGuid(), Title = "C# 编程入门", Author = "张三" } }; }

在 Program.cs 中注册它为根查询类型：

services.AddGraphQLServer().AddQueryType().AddType();

4. 启用 GraphQL 端点

在 Program.cs 的中间件管道中添加：

app.UseRouting(); app.UseEndpoints(endpoints => { endpoints.MapGraphQL(); });

默认端点是 /graphql，支持 GraphiQL（开发时自动启用）——访问 https://www./link/c3a5d96180f4811f93e797bb2bca08ee 即可调试。

基本上就这些。进阶可用 DataLoader 避免 N+1 查询，加 Mutation 支持修改操作，或集成 EF Core 自动映射数据库表。不复杂但容易忽略的是：确保所有公开字段都有 getter，且类型注册顺序合理（如 Query 依赖的类型要先注册）。

# app # 路由 # c# # .net # graphql # 中间件 # String # Object # void # 接口 # class # public # protected # 数据库 # http # 并安装 # 的是 # 进阶 # 都有 # 不需要 # 可选 # 要先 # 一个普通 # 它为 # 新建一个

返回目录在线咨询

上一篇：c# Stephen Cleary 关于异步编程的建议 c# async expert
下一篇：JS使用cookie实现只出现一次的广告代码效果

您的项目需求