如何在 GraphQL 中包含突变请求元数据？

Question

我正在使用 API 后端从头开始构建 GraphQL 服务器，以替换 REST API 服务器。目前，现有 API 服务器中的一些请求，主要是在 GraphQL 中将发生突变的 Create / Update 请求，包括客户端使用的请求 id。此请求 ID 是关于请求本身的元数据，而不是域资源的一部分。

我的问题是如何在 GraphQL 查询和突变中建模/包含请求元数据？到目前为止，我唯一的解决方案是创建一个请求类型，其他类型可以作为字段包含在内，因此请求数据可以包含在突变返回类型中。但是我不喜欢这种方法，因为它将请求数据混合到我的域类型中，这非常违背 GraphQL 的精神。是否有一种可接受的方式来传递“任意”，例如GraphQL 中的查询或突变响应中的非域类型数据？

示例 - 我想避免的：

type UserType {
  id: ID
  name: String
  request: RequestType // mixing request data in with domain type of User
}

type RequestType {
  id: ID
}

更新

对于其他对此问题感兴趣的人，根据此处的响应，我认为 GraphQL extensions 键是向 GraphQL 响应添加任意数据而不使数据成为数据图的一部分的好选择。在 Express-GraphQL 中，可以在此处找到有关向响应添加扩展键的文档：https://github.com/graphql/express-graphql#providing-extensions。这里有一个很好的扩展概述：https://marmelab.com/blog/2017/09/06/dive-into-graphql-part-iii-building-a-graphql-server-with-nodejs.html#server-logging

也就是说，如果请求元数据在概念上是域数据的一部分，那么按照下面 Kashif 的建议创建嵌入域类型的 ResponseType 可能是正确的方法。

Answer 1

这种元元素通常在每个请求的 HEADERS 中传递。然后你就可以在你的 GraphQL 服务器中随意处理这些了

例如。

//Request Headers
...

X-Request-Id: <Your_Request_Id>

...

更新

标头可以双向工作，因此在客户端上使用它们也不会有任何问题。需要时将它们从响应中拉出来。

但是，如果您真的想要突变响应中的 requestId，那么它就是您域的一部分。自定义响应类型并没有错，许多现有的 GraphQL api 确实有一个自定义响应类型，例如 LoginResponse、RegisterResponse，它会包裹您的域对象，但还会在 meta 字段中包含额外的内容

Answer 2

由于 GraphQL 被设计为与协议无关，因此您应该使用所选协议的元数据模式。如果您使用的是 HTTP，则应传递标头。如果您使用的是 WS/STOMP/MQTT/AMQP，您可以在每个帧中包含元数据。

另外，GraphQL 有一个extensions protocol。您可以在扩展对象中的响应中添加request-id。 Apollo 使用扩展来进行缓存、遥测等。

我们已经在生产环境中使用 GraphQL 大约一年了，我们犯了将元数据添加到 GraphQL 的错误，并且很难管理。不要失去您正在使用的协议的功能所带来的好处。