Apollo iOS 错误拦截器使用指南

理解错误拦截器的作用

在Apollo iOS客户端中，错误拦截器(ApolloErrorInterceptor)是一个强大的工具，它允许开发者在GraphQL请求失败时进行统一的错误处理和日志记录。与常规的请求拦截器不同，错误拦截器专门用于捕获和处理请求链中发生的错误。

错误拦截器的工作原理

错误拦截器在整个请求管道中扮演着"最后防线"的角色。当请求处理过程中发生任何错误时，控制权会立即转移到错误拦截器。需要注意的是：

1. 每个Apollo客户端实例只能设置一个错误拦截器
2. 错误拦截器接收到错误后，请求处理即终止
3. 拦截器处理完成后需要明确告知调用方错误状态

实现自定义错误拦截器

以下是一个典型的错误拦截器实现示例，展示了如何记录错误并通知调用方：

class CustomErrorInterceptor: ApolloErrorInterceptor {
    weak var errorDelegate: ErrorDelegate?
    
    func handleErrorAsync<Operation: GraphQLOperation>(
        error: Error,
        chain: RequestChain,
        request: HTTPRequest<Operation>,
        response: HTTPResponse<Operation>?,
        completion: @escaping (Result<GraphQLResult<Operation.Data>, Error>) -> Void
    ) {
        // 记录错误日志
        errorDelegate?.logError(error, for: request)
        
        // 必须调用completion来结束请求处理
        completion(.failure(error))
    }
}

关键注意事项

1. 请求终止：一旦进入错误拦截器，原始请求就已经失败，无法继续处理或恢复
2. 必须调用completion：处理完错误后必须调用completion闭包，否则调用方会一直等待
3. 避免循环调用：不要尝试再次调用chain.handleErrorAsync，这会导致无限循环
4. 线程安全：确保在正确的线程上执行所有操作，特别是UI相关的通知

最佳实践建议

1. 集中错误处理：在拦截器中实现统一的错误处理逻辑
2. 错误分类：根据错误类型采取不同的处理策略
3. 用户通知：考虑在拦截器中实现用户友好的错误提示
4. 性能监控：可以在此处添加性能监控点，记录失败请求的耗时等信息

通过合理使用错误拦截器，开发者可以大大简化应用的错误处理逻辑，提高代码的可维护性和一致性。