深入理解 GraphQL 错误处理-JavaScript中文网-JavaScript教程资源分享门户

GraphQL 作为一种强类型、可组合且易于使用的查询语言，已经被越来越多的团队所采用。但是，随着 GraphQL 的使用越来越广泛，错误处理问题也日益突出。

常见错误类型

在使用 GraphQL 过程中，常见的错误类型主要包括：

语法错误：请求的查询文本包含 GraphQL 语法错误，导致无法正确解析。
字段选择错误：请求的查询文本中选择了不存在的字段，或选择的字段不在该类型中定义，导致查询失败。
授权错误：请求的查询需要进行授权，但当前用户没有足够的权限。
数据错误：请求虽然符合 GraphQL 的语法和数据结构，但是请求的数据在业务逻辑上不合法。
服务器错误：服务器在处理 GraphQL 查询时发生了错误。

错误处理策略

针对上述错误，通常有以下几种错误处理策略：

直接崩溃

这是最常见的错误处理策略，当 GraphQL 服务发生错误时，直接返回错误信息，终止当前的查询请求。这种方式虽然简单易用，但是对于客户端来说体验很差，用户不会知道具体错误原因，也无法根据错误信息调整自己的查询文本。

抛出异常

GraphQL 服务可以在遇到错误时抛出异常，让客户端自行处理异常信息。这种方式可以大大提高客户端的灵活性，让客户端能够更好地处理和呈现查询文本的错误。但是对于普通开发者来说，要处理异常信息很麻烦，需要对异常信息进行分类、解析和处理，还需要考虑异常的嵌套和传播等问题，开发效率比较低。

定义错误码

为了简化客户端错误处理的流程，GraphQL 服务可以定义一些错误码，用于标识不同的错误类型。客户端在发起查询时可以定义一个错误处理函数，当服务器返回错误码时，将错误码和处理函数绑定起来，方便客户端进行错误处理。虽然这种方式比较灵活，但是定义错误码需要额外的开销，开发人员需要谨慎对待。

使用其他数据传输方式

在某些情况下，可以考虑使用其他数据传输方式，如 RESTful API 等。这样可以避免 GraphQL 查询时的各种错误，但是牺牲了 GraphQL 的灵活性和可组合性。

示例代码

以下是一个示例代码，展示了如何通过 GraphQL 库（此处使用 Apollo Client）处理 GraphQL 错误。在该代码中，当服务器返回错误结果时，会重新执行查询，将错误结果保存在本地，并向上抛出异常。

// javascriptcn.com 代码示例
import { ApolloClient, InMemoryCache } from "@apollo/client";

const client = new ApolloClient({
  uri: "/graphql",
  cache: new InMemoryCache(),
  onError: ({ graphQLErrors, networkError, forward, operation }) => {
    if (graphQLErrors) {
      for (const error of graphQLErrors) {
        switch (error.extensions.code) {
          case "UNAUTHENTICATED":
            // 处理授权错误
            break;
          default:
            // 其他错误，重新执行查询
            operation.setContext({
              fetchOptions: {
                credentials: "include",
              },
            });

            return forward(operation);
        }
      }
    }
  },
});

总结

GraphQL 错误处理是使用 GraphQL 的必备技能之一。针对不同的错误类型和场景，开发人员需要选择合适的错误处理策略，并在客户端和服务器端实现相应的错误处理逻辑。同时，也需要注意安全性和可扩展性等方面的问题，以保证 GraphQL 查询的质量和效率。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/654094b27d4982a6eba1696f