GraphQL 是一种新兴的 API 查询语言，越来越多的公司将其用于前端开发。相比传统 RESTful API，GraphQL 有着更好的性能、更灵活的数据获取方式以及更好的类型检查功能。然而，由于其复杂的语法以及查询方式，GraphQL 也有着一些常见的错误类型，本文将对这些错误类型进行详细介绍，并给出相应的解决办法。
错误类型一：Syntax Error
Syntax Error 是指语法错误，这是最常见的 GraphQL 错误类型。当我们在编写 GraphQL 查询或者变异时，如果语法有误，就会导致 Syntax Error。例如，下面这段查询语句中，我们少了一个大括号：
{
user(id: 1) {
name
}这段查询语句就会报错，因为缺失了一个闭合的大括号。这种错误可以通过仔细检查代码来解决。
错误类型二：Field does not exist on type
这种错误是因为我们查询的字段不存在于我们所查询的类型上。例如，我们查询一个用户的名字：
{
users {
id
names
}
}这段查询语句中，我们查询了一个名为 names 的字段，然而该字段并不存在于查询的类型上。因此，我们需要注意我们查询的字段是否存在于所查询的类型上。
错误类型三：Argument type mismatch
这种错误是因为我们在查询时给出的参数类型与所需的类型不匹配。例如，我们查询一个用户，但是我们将其 ID 传递给了一个字符串变量：
query($id: String!) {
user(id: $id) {
name
}
}这个查询语句将会引起一个 Argument type mismatch 的错误，因为我们将 ID 传递给了一个字符串变量，然而 ID 的类型应该是一个数字。因此，我们需要确保我们传递的参数类型与所需的类型匹配。
错误类型四：Server Error
Server Error 是意外行为的结果。这种错误是因为我们的 GraphQL 服务端代码中存在错误。例如，我们尝试查询一个用户，但是该用户不存在：
{
user(id: 999) {
name
}
}这段查询语句将会引起一个 Server Error 的错误，因为我们尝试查询一个不存在的用户。对于这种错误，我们需要检查服务器端代码并且更正错误。
解决 GraphQL 错误的最佳实践
为了尽可能地避免 GraphQL 错误，我们应该采用以下最佳实践：
- 使用 GraphQL 编辑器（例如 Playground 或者 GraphiQL）来编写和查询 GraphQL 语句，并且在编写前验证语法的正确性和查询的正确性。
- 通过实现自己的 GraphQL 类型系统和 Schema 来最大程度地利用 GraphQL 的类型检查功能。
- 在服务器端代码中使用 try-catch 块捕获可能出现的服务器端错误。
- 打印出错误信息并指示客户端问题的来源。
- 在编写查询语句时始终关注类型，并且确保它们之间的匹配。
示例代码
下面是一个 GraphQL 查询示例代码，该查询查询了所有的用户并返回其 ID 以及名字：
{
users {
id
name
}
}如果我们像下面这样执行一个类似的查询，但是查询一个不存在的字段：
{
users {
id
names
}
}我们会得到下面这样错误信息：
-- -------------------- ---- -------
-
--------- -
-
---------- ------- ----- ----- --------- -- ---- -----------
------------ -
-
------- --
--------- -
-
-
-
-
-这个错误告诉我们，names 字段无法在 User 类型上查询。我们需要更正错误并重新查询。
结论
GraphQL 是一个强大的 API 查询语言，并提供了更好的类型检查以及更灵活的数据获取方式。然而，由于其复杂的语法以及查询方式，我们需要注意常见的错误类型以及如何避免这些错误。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66f75beec5c563ced597be9d