如何向 GraphQL 添加“resolveType”？

Question

我正在尝试使用 GraphQL 查询单个 MongoDB 文档 (trivia)，但其中一个文档字段出现问题。 trivia.rounds 字段应该返回一个对象数组（LightningRound 或 MultipleChoiceRound）。

schema.graphql

type Trivia {
  _id: String!
  createdAt: String!
  rounds: [Round]!
}

interface Round {
  type: String!
  theme: String!
  pointValue: Int!
}

type LightningRound implements Round {
  type: String!
  theme: String!
  pointValue: Int!
  questions: [LightningRoundQuestion]
}

type MultipleChoiceRound implements Round {
  type: String!
  theme: String!
  pointValue: Int!
  questions: [MultipleChoiceRoundQuestion]
}

// ...

trivia.js // resolver

require('dotenv').config()
const { ObjectId } = require('mongodb')

const trivia = (app) => {
  return async (root, { _id }) => {
    return app
      .get('db')
      .collection(process.env.DB_COLLECTION_TRIVIA)
      .findOne(ObjectId(_id))
  }
}

module.exports = {
  trivia
}

graphql query

query {
  trivia(_id: "5e827a4e1c9d4400009fea32") {
    _id
    createdAt
    rounds {
      __typename
      ... on MultipleChoiceRound {
        type
        theme
        }
            ... on PictureRound {
        type
        theme
        }
            ... on LightningRound {
        type
        theme
        }
    }
  }
}

我不断收到错误：

"message": "Abstract type \"Round\" must resolve to an Object type at runtime for field \"Trivia.rounds\" with value { questions: [[Object], [Object]] }, received \"undefined\". Either the \"Round\" type should provide a \"resolveType\" function or each possible type should provide an \"isTypeOf\" function."

我不明白resolveType 或isTypeOf 是什么意思。我在其他问题中看到了这一点，但不知道在我的设置中实现什么。如果我删除 rounds 字段，数据库连接和解析器工作正常，所以它就在那里......

Answer 1

GraphQL 支持两种抽象类型——联合和接口。抽象类型是表示两个或多个可能类型的类型。抽象类型允许您为字段指定一种类型，该类型可能是运行时（即执行查询时）的几种可能类型之一。执行查询时，GraphQL 永远不能返回抽象类型——相反，当执行查询时，该类型必须解析为一种可能的类型。

如果一个字段返回一个列表，那么列表中每个项目的类型将单独解析。这种类型解析发生在在每个项目上的任何字段被解析之前。更重要的是，解析的类型决定了首先需要解析哪些字段。

在上面的示例中，您定义了一个抽象类型（接口Round）和几种可能的类型（LightningRound、MultipleChoiceRound 等）。 但是，您还没有告诉 GraphQL 如何确定Round 是LightningRound、MultipleChoiceRound 还是其他可能的类型。这就是提供resolveType 函数的目的。您通常为架构中的每个抽象类型定义一个 resolveType 函数。假设您使用的是graphql-tools 或apollo-server，您可以通过用于定义解析器的同一个解析器映射对象来提供此功能：

const resolvers = {
  Round: {
    __resolveType: (round) => {
      // your code here
    },
  },
}

resolveType 将传递 Round 对象（即您的 rounds 解析器返回的对象之一）——您可以使用该值来确定它是哪种 Round。根据您的代码，我猜您会使用 type 属性来区分不同的类型。 resolveType 应该返回一个带有匹配类型名称的字符串值。所以它可以很简单：

const resolvers = {
  Round: {
    __resolveType: (round) => {
      return round.type
    },
  },
}

有关其他示例，请参阅the docs。

isTypeOf 是解析类型的另一种方法。您可以为每个可能的类型定义一个isTypeOf 函数，而不是为抽象类型定义一个resolveType 函数。此函数返回 true 或 false 以指示它接收到的对象是否实际上是该类型。 isTypeOf 有一些用途，但通常使用 resolveType 更容易。