Apollo Client 中 defaultOptions 配置的深度解析

默认查询策略失效问题分析

在使用 Apollo Client 进行 GraphQL 数据查询时，许多开发者会遇到一个常见问题：在客户端初始化时配置的 defaultOptions 似乎没有生效。特别是当开发者期望通过 defaultOptions.query.fetchPolicy 设置全局的查询策略时，发现实际查询仍然使用了默认的缓存策略。

问题本质探究

这个问题的根源在于 Apollo Client 内部对不同类型操作的处理机制差异。Apollo Client 实际上区分了两种主要的操作类型：

1. 一次性查询（query）：通过 client.query() 方法直接执行
2. 观察查询（watchQuery）：通过 useQuery 钩子执行的查询

正确的配置方式

经过深入分析 Apollo Client 的源码和文档，我们发现正确的配置应该是：

const client = new ApolloClient({
  // ...其他配置
  defaultOptions: {
    watchQuery: {
      fetchPolicy: 'no-cache'
    },
    query: {
      fetchPolicy: 'no-cache' 
    }
  }
})

技术实现原理

在 Apollo Client 内部，useQuery 钩子实际上是基于 watchQuery 实现的，这就是为什么必须配置 watchQuery 才能影响钩子行为的原因。这种设计允许开发者对不同场景下的查询行为进行更精细的控制：

• 对于一次性查询（如 SSR 场景），使用 query 配置
• 对于组件内持续观察的查询，使用 watchQuery 配置

最佳实践建议

1. 如果项目同时包含两种查询方式，建议同时配置 query 和 watchQuery
2. 对于纯前端应用，通常只需要配置 watchQuery
3. 在 SSR 场景下，确保 query 配置与客户端一致

扩展思考

这种设计模式反映了 Apollo Client 架构的灵活性，它允许开发者在不同层级控制查询行为。理解这种机制不仅有助于解决配置问题，还能帮助开发者更好地设计应用的数据获取策略。

通过深入理解这些底层机制，开发者可以更自信地使用 Apollo Client 的各种高级功能，构建更健壮的 GraphQL 应用。