React Query是否支持配置全局默认查询键实现查询作用域隔离

TanStack Query（原React Query）原生没有提供QueryClientProvider上的defaultKey属性来直接配置全局查询键前缀，你提到的绑定全局默认键实现多账号缓存隔离的需求，可以通过以下两种官方推荐的方案实现，完全不需要每次调用useQuery时手动传入accountId。

方案1：封装项目统一的查询Hook（最推荐） #

这是适配性最强、侵入性最低的方案，你只需要在项目内封装一层通用的查询Hook，内部自动拼接当前账号ID到查询键的最前端即可，业务侧调用时和原生useQuery用法完全一致。

// 项目内公共Hook文件
import { useQuery as originalUseQuery } from '@tanstack/react-query'
// 导入项目内获取当前登录账号ID的自有Hook
import { useCurrentAccount } from '@/hooks/useCurrentAccount'

export const useAppQuery = (queryKey, queryFn, configs) => {
  const { accountId } = useCurrentAccount()
  // 自动拼接账号ID作为查询键第一维度，和你预期的defaultKey效果完全一致
  const scopedQueryKey = [accountId, ...queryKey]
  return originalUseQuery(scopedQueryKey, queryFn, configs)
}

• 后续业务代码直接引入useAppQuery替代原生useQuery即可自动实现账号维度的缓存隔离
• 如果后续需要新增其他全局维度的缓存隔离（比如多租户ID、环境标识），只需要修改这一处封装代码
• 建议同时封装对应的useAppMutation、useAppQueryClient，在缓存失效、手动更新缓存等操作中自动补全账号前缀，避免漏写导致跨账号数据污染

方案2：按账号维度隔离QueryClient实例 #

如果你的应用同一时间只展示单个账号的数据，不需要同时保留多个账号的缓存驻留，可以在账号切换时直接生成新的QueryClient实例，旧实例的缓存会随内存回收自动销毁，天然实现缓存隔离，不需要手动拼接查询键。

function App() {
  const { accountId } = useCurrentAccount()
  // 账号ID变化时生成全新的QueryClient，旧缓存完全隔离
  const [queryClient] = useState(() => new QueryClient())
  
  useEffect(() => {
    // 账号切换时可选清空旧缓存，避免内存占用
    queryClient.clear()
  }, [accountId, queryClient])

  return (
    <QueryClientProvider client={queryClient}>
      {/* 应用子组件 */}
    </QueryClientProvider>
  )
}

注意：queryFn是查询的执行函数，本身不负责查询键的拼接逻辑，你需要的全局默认键能力和queryFn没有直接关联。目前官方没有在Provider层支持defaultKey配置的计划，上述两种方案已经可以覆盖所有缓存作用域划分的需求。

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