Vert.X HTTP GraphQL请求Body传Query提示Query is missing怎么解决？

该io.vertx.core.impl.NoStackTraceThrowable: Query is missing报错核心原因是Vert.X GraphQL模块未从请求中提取到有效的查询语句，仅在请求Body中传递时触发的常见诱因如下：

• BodyHandler注册顺序错误：Vert.X的路由handler按注册顺序执行，若你在GraphQL端点handler注册完成后才添加router.route().handler(BodyHandler.create());配置，请求到达GraphQL handler时BodyHandler还未完成请求体解析，自然无法读取到Body内的query参数。
• 请求Content-Type不符合要求：Vert.X GraphQL HTTP适配器默认仅对application/json、application/graphql类型的请求体做查询提取，若请求未指定对应Content-Type头，或使用multipart/form-data、text/plain等不支持的类型，即使BodyHandler解析了请求体，GraphQL模块也不会从Body中读取query。
• 请求体结构不符合规范：若使用application/json类型传参，请求体必须为合法JSON结构且包含query根字段，若JSON格式非法、字段名拼写错误，也会被判定为查询缺失。

按优先级依次排查修改即可：

1. 调整BodyHandler注册顺序，确保它在所有业务handler（包含GraphQL端点handler）之前注册，正确示例代码：

// 第一步先全局注册BodyHandler
router.route().handler(BodyHandler.create());
// 第二步再注册GraphQL等业务端点handler
router.post("/graphql").handler(graphQLHandler);

2. 校验请求配置：

• 若请求体为JSON结构的GraphQL请求，必须添加请求头Content-Type: application/json，请求体格式示例：{"query": "{ user(id: 1) { name } }"}
• 若请求体为原生GraphQL查询字符串，必须添加请求头Content-Type: application/graphql，请求体直接填写查询语句即可

3. 若有自定义请求体结构的需求，可以通过GraphQLHandler的前置处理逻辑自行提取查询，示例代码：

GraphQLHandler graphQLHandler = GraphQLHandler.create(graphQLInstance)
  .beforeExecute(contextBuilder -> {
    RoutingContext routingCtx = contextBuilder.routingContext();
    // 自定义从请求体中提取query的逻辑
    String query = routingCtx.getBodyAsJson().getString("custom_query_field");
    contextBuilder.query(query);
  });

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