Apollo iOS 中 TokenAddingInterceptor 响应值为 nil 的解决方案

问题背景

在 Apollo iOS 项目中，开发者经常需要为 GraphQL 请求添加认证 Token。常见做法是使用拦截器(Interceptor)机制，在请求发出前修改请求头。然而，有些开发者在实现 TokenAddingInterceptor 时发现 response 值为 nil，这实际上是一个对拦截器工作机制的误解。

拦截器执行顺序分析

Apollo iOS 的拦截器链(Interceptor Chain)按照特定顺序执行，每个拦截器都有其明确职责：

1. 请求准备阶段：在请求实际发送前执行的拦截器
2. 网络请求阶段：NetworkFetchInterceptor 负责实际发送网络请求
3. 响应处理阶段：请求返回后处理响应的拦截器

核心问题定位

TokenAddingInterceptor 的主要目的是在请求发出前添加认证信息，因此它应该：

• 操作的是**请求(request)**而非响应(response)
• 需要在网络请求发生之前执行
• 不需要也不应该期待在这个阶段有响应对象

正确实现方案

正确的 TokenAddingInterceptor 实现应该专注于修改请求头：

class TokenAddingInterceptor: ApolloInterceptor {
    func interceptAsync<Operation: GraphQLOperation>(
        chain: RequestChain,
        request: HTTPRequest<Operation>,
        response: HTTPResponse<Operation>?,
        completion: @escaping (Result<GraphQLResult<Operation.Data>, Error>) -> Void
    ) {
        // 添加Token到请求头
        request.addHeader(name: "Authorization", value: "Bearer your_token_here")
        
        // 继续处理链
        chain.proceedAsync(request: request,
                          response: response,
                          completion: completion)
    }
}

拦截器注册的正确位置

在 DefaultInterceptorProvider 子类中，Token 拦截器应该放在拦截器数组的开头：

override func interceptors<Operation: GraphQLOperation>(for operation: Operation) -> [ApolloInterceptor] {
    var interceptors = super.interceptors(for: operation)
    interceptors.insert(TokenAddingInterceptor(), at: 0)
    return interceptors
}

高级应用场景

对于更复杂的认证场景，如 Token 刷新，可以考虑：

1. 实现双重拦截器：一个负责添加 Token，一个负责检测过期并刷新
2. 使用 Apollo 的 RequestChain 机制处理认证失败情况
3. 结合本地缓存策略减少不必要的认证请求

性能优化建议

1. 避免在拦截器中执行耗时操作
2. 对 Token 进行内存缓存，减少重复获取
3. 合理设置拦截器优先级，确保关键操作优先执行

总结

理解 Apollo iOS 拦截器的工作流程是正确实现认证机制的关键。TokenAddingInterceptor 应该在请求阶段操作请求对象，而非期待响应对象。通过合理设计拦截器链，可以构建灵活且强大的 GraphQL 客户端认证体系。