Apollo Client 中 useLazyQuery 错误处理的深度解析

问题背景

在 Apollo Client 3.11.4 版本中，开发团队发现了一个关于 useLazyQuery Hook 的错误处理不一致性问题。具体表现为：当设置 errorPolicy 为 "all" 时，查询结果的 error 字段未被正确填充，而 errors 字段却能正常获取错误信息。

技术细节分析

错误字段的演变

Apollo Client 在最近的更新中开始逐步弃用 QueryResult.errors 字段，推荐开发者使用 error.graphQLErrors 替代。然而，这一变更在实际使用中出现了不一致的行为：

1. 当 GraphQL 解析器抛出异常时，errors 属性总是会被设置
2. 但 error 字段仅在 errorPolicy 设置为 "none" 时才会被填充

问题复现场景

通过实际测试发现以下行为模式：

1. 使用 errorPolicy: "all" 时：

   • result.error 为 undefined
   • result.errors 包含实际的 GraphQL 错误

2. 改为 errorPolicy: "none" 时：

   • 两个字段都会被正确填充

并发查询的异常情况

更复杂的是，当开发者连续发起两个查询（不等待第一个完成就发起第二个），且第一个失败而第二个成功时：

• 失败查询的结果中 error 字段为 undefined
• 这种异常行为在 3.10.8 版本中不存在，从 3.11.0 开始出现

解决方案与改进

Apollo 团队在 4.0 版本中对此问题进行了彻底修复：

1. 移除了 errors 字段，统一使用 error 字段处理所有错误
2. 增强了测试套件，确保此类问题不会再次被忽视
3. 提供了更一致的错误处理体验

开发者建议

对于正在使用 3.x 版本的开发者：

1. 如果需要完整的错误信息，暂时使用 errorPolicy: "none"
2. 或者直接访问 errors 字段获取 GraphQL 错误

对于准备升级的开发者：

1. 可以尝试 4.0 alpha 版本体验改进后的错误处理
2. 注意新版本中错误处理 API 的变化

总结

这个问题的出现反映了 Apollo Client 在错误处理机制上的演进过程。从最初的 errors 字段到统一的 error 字段，开发团队正在简化 API 并提高一致性。对于依赖错误处理的应用程序，建议密切关注 4.0 版本的发布，并计划相应的升级策略。