Apollo Client中useSuspenseQuery与skipToken的严格模式问题分析

问题背景

在React应用开发中，Apollo Client作为GraphQL客户端被广泛使用。其3.9.10版本引入了一个值得注意的行为变化：当结合React的严格模式(StrictMode)使用时，useSuspenseQuery钩子与skipToken配合会出现意外的网络请求问题。

问题现象

开发者发现，即使在代码中明确使用了skipToken来跳过查询，useSuspenseQuery仍然会发起网络请求。经过排查，这个问题仅在以下条件同时满足时出现：

1. 使用Apollo Client 3.9.10版本
2. 应用运行在React的严格模式下
3. 使用useSuspenseQuery而非普通的useQuery

技术分析

skipToken的设计意图

skipToken是Apollo Client提供的一个特殊标记，用于条件性地跳过查询执行。当传递给useSuspenseQuery时，理论上应该：

• 将查询设置为fetchPolicy: "standby"模式
• 完全避免发起任何网络请求
• 返回undefined作为数据

严格模式的影响

React的严格模式会故意执行某些操作两次（如渲染函数），以帮助开发者发现潜在问题。正常情况下，这不应该影响Apollo Client的跳过查询逻辑，但在3.9.10版本中却出现了异常。

版本差异

关键发现是：

• 3.9.9及以下版本：行为正常，严格模式下也能正确跳过查询
• 3.9.10版本：严格模式下会错误地发起网络请求

这表明3.9.10版本中引入的某些变更与React严格模式的机制产生了冲突。

解决方案与建议

对于遇到此问题的开发者，可以考虑以下方案：

1. 临时降级：回退到3.9.9版本，等待官方修复
2. 替代方案：在严格模式下使用useQuery配合{skip: true}选项
3. 移除严格模式：如果项目允许，暂时移除<React.StrictMode>包装

技术启示

这个案例展示了几个重要的技术要点：

1. 严格模式的敏感性：即使是成熟的库也可能在严格模式下暴露隐藏的问题
2. 版本控制的重要性：小版本号升级也可能引入重大行为变化
3. 测试覆盖的必要性：官方承认167个测试用例中未覆盖此场景，强调了边界条件测试的价值

总结

Apollo Client 3.9.10中useSuspenseQuery与skipToken在严格模式下的异常行为是一个典型的版本兼容性问题。开发者在使用这些较新的API时，特别是在严格环境下，应当注意版本差异并进行充分测试。目前建议关注官方后续版本的修复情况，同时可以采用上述临时解决方案规避问题。