GraphQL 是一种强类型的查询语言，在前端领域中，它广泛应用于构建 API。与传统的 RESTful API 相比，GraphQL 可以更加精细地定义数据结构和查询方式，有利于前后端分离和代码维护。但是，当我们使用 GraphQL 构建 API 时，错误处理依然是一个不可避免的问题。如何在 GraphQL 中处理错误，保障 API 的稳定性和可靠性，是一个需要我们深入思考和研究的问题。
错误处理的重要性
错误处理是任何 API 设计中不可或缺的一部分。在 GraphQL 中，错误会发生在以下情况：
- 请求错误：请求无法被服务器正确处理，例如接口 API 不存在或请求方式错误等。
- 数据验证错误：数据验证不成功，例如请求参数格式错误、参数类型不正确或者请求参数缺少等。
- 业务逻辑错误：请求处理中出现业务逻辑上的错误，比如请求的参数没有通过业务逻辑的验证或者请求处理过程中出现了错误。
- 系统错误：API 服务器在处理请求时发生系统级别的错误，例如服务器繁忙、网络故障或者硬件故障等。
这些错误都可能导致 API 的不稳定，以及用户体验的下降。因此，错误处理是构建 GraphQL API 的一个重要环节，需要我们深入掌握。
GraphQL 中的错误处理
在 GraphQL 中，我们可以通过以下方式实现错误处理：
1. 返回空值
当不能返回正确的结果时，我们可以返回空值（null）。这种方法不会抛出异常，因此比较安全，但是也给前端应用造成困扰，需要显式地进行空值处理，为开发增加了额外的负担。
2. 抛出异常
GraphQL API 使用原生异常来表示错误。这个做法基于 GraphQL 的一种设计哲学：明确错误发生的原因，而不是隐藏和忽略它们。在 GraphQL 中，我们可以通过抛出以下异常来实现错误处理：
GraphQL::ExecutionError：表示请求时出现错误，例如请求参数、类型、字段等不正确。GraphQL::UnauthorizedError：表示请求时出现权限错误，例如用户未登录或没有足够的权限。GraphQL::InternalError：表示请求时出现了内部错误，例如数据层出现异常或后台程序崩溃。
无论是何种方式，当异常被捕获之后，都应该返回一个错误对象，包含以下信息：
- code：错误码，用于前端进行错误码处理。
- message：错误描述，用于前端展示错误信息。
- data：错误数据，用于前端处理错误数据时使用。
3. 返回一个错误类型
GraphQL 中的类型可以用来定义许多我们网站需要的类型，比如用户、商品、评论等。但是，我们也可以通过定义一个错误类型来方便地处理错误。
在 GraphQL 中，我们可以定义一个Error类型，它包含以下信息：
type Error {
code: Int!
message: String!
data: JSON
}其中，code和message属性和上述异常一致，data属性像上述代码一样，在需要时添加额外信息。
错误处理示例代码
以下是一段处理 GraphQL 错误的示例代码：
// javascriptcn.com 代码示例
type Query {
# 获取单个学生信息
student(id: Int!): Student!
@throws(exception: "GraphQL::UnauthorizedError")
@throws(exception: "GraphQL::InternalError")
@throws(exception: "GraphQL::ExecutionError")
}
type Mutation {
# 添加学生
addStudent(input: StudentInput!): Student!
@throws(exception: "GraphQL::UnauthorizedError")
@throws(exception: "GraphQL::InternalError")
@throws(exception: "GraphQL::ExecutionError")
}
type Student {
id: Int!
name: String!
age: Int!
grade: String!
}
input StudentInput {
name: String!
age: Int!
grade: String!
}
type Error {
code: Int!
message: String!
data: JSON
}在上述代码中，我们定义了一个 Error 类型，用于表示出现的错误。定义了查询和变异，和涉及到不同类型的钩子处理错误。
总结
错误处理在构建 GraphQL API 中是不可避免的，通过了解 GraphQL 中的错误处理，我们可以在保证 API 稳定性和可
来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/653f90817d4982a6eb9205b8