React Query 5.59.14 版本中无限查询选项的类型兼容性问题分析

在 React Query 5.59.14 版本中，开发者在使用 infiniteQueryOptions 时遇到了类型兼容性问题。这个问题主要出现在 TypeScript 严格模式（strict: true）和精确可选属性类型（exactOptionalPropertyTypes: true）配置下。

问题背景

React Query 是一个流行的数据获取库，提供了 useInfiniteQuery 和 useSuspenseInfiniteQuery 两个钩子来处理分页数据加载。在 5.59.14 版本中，infiniteQueryOptions 的类型定义发生了变化，导致其返回的类型不再同时兼容这两个钩子。

技术细节

问题的核心在于 infiniteQueryOptions 的类型定义。在 5.59.14 版本中，它使用了 UnusedSkipTokenInfiniteOptions 类型，而这个类型不被 useInfiniteQuery 的任何重载所支持。相比之下，之前的 5.59.9 版本使用的是 UndefinedInitialDataInfiniteOptions 类型，能够正常工作。

解决方案

开发团队通过修改 infiniteQueryOptions 的类型定义解决了这个问题。具体做法是在 queryFn 属性的类型定义中添加 | undefined，使其能够兼容严格模式下的类型检查。

影响范围

这个问题主要影响以下场景：

• 使用 TypeScript 严格模式的项目
• 启用了 exactOptionalPropertyTypes 配置的项目
• 同时使用 useInfiniteQuery 和 useSuspenseInfiniteQuery 的代码

最佳实践

对于遇到类似问题的开发者，建议：

1. 检查 TypeScript 配置，特别是严格模式相关选项
2. 确保使用的 React Query 版本与项目配置兼容
3. 在升级库版本时，注意查看变更日志中的类型定义变化

这个问题展示了在严格类型检查环境下，类型定义的精确性对代码兼容性的重要影响，也体现了 React Query 团队对类型安全的重视。