TanStack Query 中 ESLint 规则对可选链的误报问题分析

问题背景

在 TanStack Query 项目中，开发者使用 @tanstack/query/exhaustive-deps ESLint 规则时遇到了一个关于可选链操作符(?.)的误报问题。当在 queryKey 中使用可选链访问属性时，ESLint 规则会错误地提示缺少依赖项。

问题重现

开发者提供了两个典型的使用场景：

1. 第一种情况是在 queryKey 中使用 data?.address，同时在 queryFn 中使用非空断言 data!.address，ESLint 错误地提示缺少 data 依赖。

2. 第二种情况是在 queryKey 中使用 data?.address，在 queryFn 中直接使用 data.address，ESLint 错误地提示缺少 data.address 依赖。

技术分析

这个问题源于 ESLint 规则对可选链操作符的解析不够完善。可选链是 ES2020 引入的特性，它允许安全地访问可能为 null 或 undefined 的属性。然而，当前的规则实现没有完全考虑到这种语法特性。

在 TanStack Query 的上下文中，queryKey 用于唯一标识查询，当依赖项变化时，查询会自动重新获取数据。因此，确保 queryKey 包含所有必要的依赖项非常重要。

解决方案

项目维护者已经确认这是一个需要修复的问题，并在相关测试用例中重现了这个问题。修复方案将改进规则对可选链操作符的处理逻辑。

作为最佳实践建议，开发者可以考虑使用 skipToken 来类型安全地禁用查询，这比使用可选链和 enabled 标志的组合更加类型安全。

总结

这个案例展示了静态分析工具在处理新语法特性时可能面临的挑战。对于 TanStack Query 用户来说，了解这个限制可以帮助他们在开发过程中更合理地使用可选链操作符，同时期待未来版本的修复。

在等待官方修复的同时，开发者可以暂时使用非空断言或完整的依赖项列表作为变通方案，但需要注意这些方法可能带来的类型安全问题。