Error: No QueryClient set, use QueryClientProvider to set one
TanStack Query hooks ran outside a QueryClientProvider (or a duplicate copy of the library is installed).
No QueryClient set, use QueryClientProvider to set one Meaning
useQuery needs the client from context. Missing provider, tests without it, or two versions of @tanstack/react-query (separate contexts) cause it.
Common causes
- QueryClientProvider missing at the root
- Tests rendering without a provider
- Duplicate library versions / monorepo duplicates
⚡ Quick fix
- Wrap the app in <QueryClientProvider client={queryClient}>
- Provide a wrapper in tests
- Deduplicate with npm ls @tanstack/react-query
Detailed fix by platform
React
- jsx
const queryClient = new QueryClient(); <QueryClientProvider client={queryClient}><App /></QueryClientProvider>
How to diagnose
- Provider — At the root?
- Copies — One library version?
🔧 Still not fixed?
Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:
Similar errors
- Adjacent JSX elements Adjacent JSX elements must be wrapped in an enclosing tag. Did you want a JSX fragment <>...</>?
- createContext only works in Client Components Next.js: You're importing a component that needs createContext. It only works in a Client Component but none of its parents are marked with "use client"
- Flask app context RuntimeError: Working outside of application context.
Most viewed in React
- React must be in scope ReferenceError: React is not defined / 'React' must be in scope when using JSX
- Objects are not valid as a React child Error: Objects are not valid as a React child
- Functions cannot be passed Error: Functions cannot be passed directly to Client Components unless you explicitly expose it by marking it with "use server".
Other ways to find it
Where this error sits
Origin: On your device. Errors that are often confused with or caused by this one (click to open):
🧠 Still stuck? Analyze your error
Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.
💬 What worked for others
No tips yet — did something else fix this for you?
Share what worked for you
Tips are checked by an editor before they appear. Links are removed.
Report a correction or suggest an improvement
Last updated 12 Oct 2026