You need to enable JavaScript to run this app. React Query项目出现queryClient.defaultQueryObserverOptions报错
优惠活动
大模型
产品
解决方案
定价
更多

React Query项目出现queryClient.defaultQueryObserverOptions报错

报错核心成因
  • 直接触发报错的原因:App.js 中给QueryClientProvider的client属性传入的是QueryClient构造类本身,而非类的实例。QueryClient是用来生成请求客户端的构造函数,只有通过new关键字实例化后,才会挂载defaultQueryObserverOptions这类内部核心方法,直接把构造函数当实例传给Provider,自然会触发TypeError: queryClient.defaultQueryObserverOptions is not a function的报错。
  • 潜藏的运行风险:Users.js 中没有做空值兜底,在请求加载、请求失败的场景下,data字段值为undefined,直接调用data.map()会触发新的空引用报错。
  • 依赖导入匹配问题:早期独立分发的react-query-devtools包已经逐步停止独立维护,新版本能力已经合并到主包的子路径下,单独安装并从独立包路径导入,很容易出现版本错位引发的运行异常。
完整修复步骤
  • 修正 App.js 的客户端初始化逻辑
    移除错误的类传递写法,先实例化QueryClient,再把实例传给Provider,同时把DevTools的导入路径调整为内置子路径:
    import { QueryClient, QueryClientProvider } from 'react-query';
    // 从主包的子路径导入DevTools,无需依赖独立的react-query-devtools包
    import { ReactQueryDevtools } from 'react-query/devtools';
    import Users from './Users';
    
    // 正确实例化客户端
    const queryClient = new QueryClient();
    
    function App() {
      return (
        <div className="App">
          <QueryClientProvider client={queryClient}>
            <Users />
            <ReactQueryDevtools initialIsOpen={false} />
          </QueryClientProvider>
        </div>
      );
    }
    
    export default App;
    
  • 修正 Users.js 的空值兜底逻辑
    把加载、错误状态的判断提前做拦截,避免在数据未就绪时调用数组方法:
    import React from 'react'
    import { useQuery } from 'react-query';
    
    const Users = () => {
        const { isLoading, isError, data, error } = useQuery('test', () => 
            fetch('https://jsonplaceholder.typicode.com/users').then((res) => res.json())
        );
    
        // 状态拦截,不满足渲染列表条件时直接返回对应提示
        if (isLoading) return <h2>Chargement...</h2>
        if (isError) return <h2>Une erreur est survenue : {error.message}</h2>
    
        return (
            <div>
                <ul>
                    {data.map((user) => (
                        <li key={user.id}>{user.name}</li>
                    ))}
                </ul>
            </div>
        )
    }
    
    export default Users
    
  • 依赖安装校验
    如果你之前安装的依赖存在版本错位,可以重新安装匹配的稳定版本:
    • 安装主包:npm install react-query@3.39.0(这是最后一个使用react-query包名的稳定大版本,新版本已更名为对应TanStack生态包)
    • 移除冗余的独立devtools包:npm uninstall react-query-devtools,避免独立包和主包版本不匹配的问题。

内容的提问来源于stack exchange,提问作者Jonathan Viault

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 07:06:10