传递给react-query的useQuery等钩子参数是否需保持引用稳定？

针对你提出的三个问题，结合React Query的内部实现逻辑和社区实践，答案如下：

1. 是否必须保证useQuery、useMutation等钩子的入参引用稳定？ #

不是语法层面的强制要求，不会直接导致代码报错，但属于必须遵守的性能最佳实践。
官方文档没有把这点列为硬性要求，是因为库内部本身做了浅比较的兜底逻辑，不会因为一次引用变化就直接触发异常。但如果长期传入不稳定的入参，很容易触发非预期的行为和性能问题，你在现有代码库里看到的统一做引用稳定处理的写法，不是冗余代码，是经过大量实践验证的合理写法。

2. 入参引用不稳定是否会导致每次重渲染都重复执行逻辑？ #

不会每次重渲染都触发实际的服务端请求——React Query会优先对queryKey做浅比较，只要queryKey值没变，就不会重新发起网络请求。
但不稳定的入参会带来其他不必要的执行开销：

• 每次重渲染时，React Query内部的订阅观察者都会重新同步配置、重新计算派生状态，产生无意义的性能消耗
• 如果配置中传入了onSuccess、onError、onSettled这类回调，引用变化可能导致回调在非预期的时机被重复执行
• 在v3及更早的版本中，不稳定的配置引用甚至可能导致重试逻辑、窗口聚焦重拉、缓存失效等核心逻辑出现边界异常

你给出的示例中把queryOptions抽到Hook外部定义，就是避免这类问题最简单的写法。反面示例是直接把配置对象写在useQuery的参数位置，每次组件重渲染都会生成全新的配置对象引用：

// 不推荐写法：每次渲染生成新的options引用
export function useSomeServerStuff() {
  return useQuery(['query key'], fetchSomeStuff, {
    staleTime: 5 * 60 * 1000,
    cacheTime: 30 * 60 * 1000
  });
}

如果组件重渲染频率很高，这类写法带来的性能损耗会非常明显。

3. 入参引用变化是否会导致返回值属性的引用变更？ #

会。
React Query对返回的状态对象、mutate、refetch等方法做的记忆化缓存，是依赖入参引用和内部状态的。如果每次传入的入参都是新引用，记忆化逻辑会直接失效，返回的方法、状态对象每次渲染都会生成新的引用。
这带来的连锁影响非常常见：

• 如果把mutate、refetch作为依赖传入useEffect、useCallback，会导致副作用逻辑非预期重复执行
• 如果把返回值传给通过React.memo做了渲染优化的子组件，会直接导致memo优化失效，子组件跟着父组件无意义重渲染

常用的入参稳定方案 #

• 不依赖组件状态的queryKey、queryFn、配置项，直接抽到组件/自定义Hook的外部定义，和你示例中的写法一致
• 依赖组件内部状态的queryFn用useCallback包裹，动态配置项用useMemo包裹，保证依赖不变时引用不变
• 通用的全局配置可以直接在初始化QueryClient时设为默认值，不需要每次调用钩子都重复传入

内容的提问来源于stack exchange，提问作者Dimitris Karagiannis