HotChocolate实现GraphQL Mutation时Schema无法识别Query类型异常

错误原因 #

HotChocolate 默认开启Schema严格校验，遵循GraphQL官方规范要求：所有GraphQL Schema必须至少定义一个Query类型，你当前仅配置了Mutation类型，缺少Query类型触发校验失败。

解决方案 #

提供两种可选方案，推荐使用第一种符合规范的处理方式：

方案1：添加空Query类型（推荐） #

1. 定义一个空的Query类即可，不需要写任何业务逻辑：

public class Query
{
    // 可留空，后续需要查询功能时再补充业务逻辑即可
}

2. 修改Startup.cs中的GraphQL配置，注册Query类型：

public void ConfigureServices(IServiceCollection services)
{
    services.AddGraphQLServer()
        .AddQueryType<Query>() // 新增此行注册Query类型
        .AddMutationType<Mutation>();
}

方案2：关闭Schema严格校验（不推荐） #

如果确实不需要Query类型，可直接关闭严格校验规则，无需新增Query类：

public void ConfigureServices(IServiceCollection services)
{
    services.AddGraphQLServer()
        .ModifyOptions(options => options.StrictValidation = false) // 新增此行关闭严格校验
        .AddMutationType<Mutation>();
}

注意：该方案不符合GraphQL官方规范，可能导致后续第三方GraphQL客户端、工具兼容异常，仅建议临时调试使用。

额外优化提示 #

你当前Mutation类中的Book方法标记了async关键字，但方法内没有任何await操作，会触发编译警告，可选择去掉async关键字，或补充对应的异步业务逻辑。 #

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