错误处理

每次您执行一个GraphQL 操作使用 Apollo Kotlin（或任何其他GraphQL 客户端），都可能出现以下两种类型的错误：

网络错误：由于与您的 GraphQL 服务器实际通信时发生错误，没有收到 GraphQL 响应。这可能是 SSL 错误，您的应用程序离线时的套接字错误，或者 500 或任何其他 HTTP 错误。当发生网络错误时，不会返回任何数据。
GraphQL 错误：已收到 GraphQL 响应，并且它包含非空内容errors 字段。这意味着服务器无法完全处理查询。响应可能包含部分数据，如果服务器能够处理部分的查询。

网络错误

网络错误抛出 ApolloException。要处理它们，请在 query 中使用 try/catch 块：

1
try {
2
  val response = apolloClient.query(query).execute()
3
} catch(exception: ApolloException) {
4
  // handle exception here
5
}

原因

网络错误的可能原因包括（但不限于）

应用离线或无法访问网络。
出现DNS错误，无法查找宿主。
发生SSL错误（例如，服务器证书不受信任）。
连接被关闭。
服务器返回非成功的HTTP代码。
服务器没有返回有效的JSON。
响应JSON不符合模式且无法解析。
请求指定为CacheOnly但数据没有被缓存。

检查异常以获取有关实际错误的更详细信息。

GraphQL错误

因为 GraphQL 错误可能仍然包含数据，所以它们不会抛出。相反，它们返回一个 Response，其中包含一个 Response.errors 字段，指示发生的错误。

例如，以下 query 使用无效的 id 来查找 Person：

1
query FilmAndPersonQuery {
2
  film(id: "ZmlsbXM6MQ==") {
3
    title
4
  }
5
  person(id: "badId") {
6
    name
7
  }
8
}

服务器将发送以下响应

1
{
2
  "data": {
3
    "film": {
4
      "title": "A New Hope"
5
    },
6
    "person": null
7
  },
8
  "errors": [
9
    {
10
      "message": "No entry in local cache for https://swapi.dev/api/people/m�H/",
11
      "locations": [
12
        {
13
          "line": 35,
14
          "column": 3
15
        }
16
      ],
17
      "path": [
18
        "person"
19
      ]
20
    }
21
  ]
22
}

请注意，尽管存在错误，但query 成功返回了电影的标题： A New Hope。一般来说，如果在执行操作时出现任何错误，则错误会向下一个可空字段吐出。向上冒泡在这种情况下，person 是可空的。在最坏的情况下，如果其他所有内容都不是可空的，则response.data 可以是 null。

Apollo Kotlin 允许你访问Response 类中的数据和错误：

1
val response = try {
2
  apolloClient.query(query).execute()
3
} catch(exception: ApolloException) {
4
  // Network error, not much to do
5
  throw exception
6
}
7

8
// It's possible to display the film title
9
val title = response.data?.film?.title
10
if (title != null) {
11
  println(title)
12
}
13

14
// The person triggered an error
15
val person = response.data?.person?.name
16
if (person != null) {
17
  // do something with response.errors
18
}

忽略部分数据

如果您不想要处理部分响应，则可以简化错误处理逻辑。ApolloResponse.dataAssertNoErrors 返回一个非可为空的 data 在有错误时抛出。这样，您可以在单个 catch {} 块中处理所有错误：

1
val data = try {
2
  apolloClient.query(query).execute().dataAssertNoErrors
3
} catch(exception: ApolloException) {
4
  // All network or GraphQL errors are handled here
5
  throw exception
6
}
7

8
// No need for safe calls on data
9
val title = data.film?.title

请注意，在 film 上仍需要安全调用，因为这个字段在 GraphQL模式中是可为空的类型。在代码生成中存在覆盖此情况的方法。有关更多详细信息，请了解 @nonnull 指令。

GraphQL变量

自定义标量