Home Search Pricing Get inErrata About

Sign in Sign up

Graph/react-query-graphql-integration-drift

AntiPattern

GraphQL/React-Query Integration Drift

react-query-graphql-integration-drift

Data-fetching hooks get broken or mis-typed when GraphQL/REST wrappers, query key composition, or generated hook exports don’t match what react-query expects, causing stale/incorrect selections, background-refetch overwrites, or unusable types.

Node Details

Public graph metadata

Updated8/1/2026

Connections

30 linked nodes

MATCHESSolution

Leverage React 18's `useSyncExternalStore` — ensure consistent state between SSR and CSR. Tension: client-side state doesn't sync properly with the server-rendered state. Outcome: to ensure consistent state between SSR and CSR.

MATCHESSolution

Instead of `useRef`, we can change it to `useState` — for a DOM node that may not exist or change during the component's render. Tension: so that we can track ref changes in the state and trigger re-renders as needed.

MATCHESSolution

You should really use tag validation to trigger your query endpoints to refetch upon any successful mutation. — onSuccess: async () => { await queryClient.invalidateQueries({ queryKey: ["vehicle.getVehiclesWithMakes"],. Tension: Both are less than ideal. Outcome: await queryClient.invalidateQueries({ queryKey: ["vehicle.getVehiclesWithMakes"], // <-- invalidates tag key });.

MATCHESSolution

Checkout react-query documentation - https://tanstack.com/query/latest/docs/framework/react/guides/suspense#suspense-on-the-server-with-streaming — with suspense on server side. Tension: this working with suspense on server side. Outcome: there is a provision to get this working with suspense on server side.

MATCHESSolution

Use a global or local state to control the DnD UI, then sync that state with React Query data and update the server on drag end

MATCHESSolution

With useQuery you have an initialData ! — useQuery({ queryFn: () => getTodos(), queryKey: todoKeys.lists(), initialData: [] }). Tension: your data will not be undefined. Outcome: With this your data will not be undefined.

MATCHESSolution

useQuery has enabled option. Rewrite your custom hook like this: — return useQuery({. Outcome: enabled,.

MATCHESSolution

make sure that the form component is only rendered after data is ready — Decouple the data fetching component from the form component. Tension: background refetches will not be reflected. Outcome: if your cache already has stale data when `App` mounts, you'll get that data in your state.

MATCHESSolution

I try putting a setName(data.name) inside a useEffect that runs only when "isLoading" changes, and it works — edit/change the "name" retrieved by the query. Tension: I would think there is a better and more clean way to do it. Outcome: use a `useEffect` hook to "synchronize" a React state to an external source.

MATCHESSolution

An alternative would be to lift the query up higher in the ReactTree — conditionally render the child component with the fetched `name` as a prop. Tension: useState(props.name).

MATCHESSolution

Tension: despite that being what the react-query docs suggested. Outcome: This solved the type errors too.

MATCHESSolution

In short, `initialData` goes straight to the cache, while `placeholderData` is something that is only returned for the component instance using it — React Query v5 useQuery hook. Tension: `placeholderData` is not real, so the Query will behave as if it were in `pending` state. Outcome: That influences how refetches are done, and what happens to that data if the query goes into error state.

MATCHESSolution

Call `trpc...useQuery` at the component top level, destructure `{ data }`, and then use `useEffect` (or derived rendering) to react to changes in `data`. Optionally control execution with query options (e.g., enabling based on `activeChildId`) instead of wrapping the hook call in `useEffect`.

MATCHESSolution

setQueryData(['todo', todo.id], todo) — any child components that need to render that data can just get the Todo object from the react-query cache. Tension: with only the `id` field being passed as a prop. Outcome: Then any child components that need to render that data can just get the Todo object from the react-query cache.

MATCHESSolution

You don't need to define your own `QueryResult` type, you can import it from `@tanstack/react-query`. Outcome: If you need to refine it, use `Pick`.

MATCHESSolution

return response.data; — queryFn: async () => { const response = await fetchMaterial();. Tension: Only plain objects, and a few built-ins, can be passed to Client Components from Server Components.

MATCHESSolution

use the query in script setup but as not enabled so that it does not start fetching right away — to run it in click handler. Tension: vue-query can only be called from setup function only. Outcome: then use `refetch` method to run it in click handler.

MATCHESSolution

Align Tanstack Query package versions per the official React Query SSR/Next.js guide and use the correct SSR hydration components (Hydrate/DehydratedState/QueryClientProvider) as shown in the documentation.

MATCHESSolution

Your back end can use other services including REST-based ones — Making both styles of requests from your front-end is just messy. Tension: react-query can tie to both REST and GraphQL APIs but that's messy. Outcome: It would be cleaner if your back-end and front-end communicated exclusively using GraphQL.

MATCHESSolution

Wrap you components that rely on React Query data — React Query data. Outcome: with Suspense and HydrationBoundary.

MATCHESSolution

Use Next.js caching invalidation and caching controls by applying `revalidateTag` and `unstable_cache` so the Postgres queries are refreshed appropriately instead of relying on stale cached responses.

MATCHESSolution

Switch to GraphQL and call the pullRequest convertToDraft mutation after fetching the PR node ID

MATCHESSolution

Use React.useMemo to create the parameterized selector, or use the generated useGetAccountsQuery hook directly.

MATCHESSolution

Call each RTK Query hook with the exact same query arguments (or none, if the endpoint takes none) that the fulfilled requests use, and ensure components read the correct hook data/selector result corresponding to those cache entries.

MATCHESSolution

Annotate the exported hooks with TypedUseQuery instead of relying on the inferred hook type

MATCHESSolution

I want to show the data of customers from Redux — when I use `useSelect` to retrieve the data from the store. Tension: entries.map is not a function. Outcome: retrieve the data from the store.

MATCHESSolution

There isn't any `getData` endpoint declared so there will not be any `useGetDataQuery` hook generated. — export const { useGetDataQuery } = apiSlice;. Tension: only `useGetWines-X` hooks will be generated. Outcome: export const { useGetWinesQuery } = apiSlice;.

MATCHESSolution

const { data } = await thunkApi.dispatch( userApi.endpoints.login.initiate(credentials); );. Tension: I want to use `fetchBaseQuery` in the API call. Outcome: You can initiate an endpoint directly.

MATCHESSolution

You cannot directly “forge” or mutate props from outside React; enforce integrity by keeping sensitive logic/validation on the server, using proper state management, and treating any user-provided data as untrusted with validation.

MATCHESSolution

I'm having SEO issues with a nextJS app where the meta data is being outputted outside of the body tag — I'm using the app router on Next 15.2.3. Tension: Weirdly, if I hard refresh the meta data shows in the head, but when I do a normal refresh it moves down below the script tags at the bottom of the page. Outcome: inside generateBusinessMeta data there is a supabase data fetch.

[inerrata]Tags Knowledge Graph Docs About Team Pricing Contact Report a Bug Privacy Terms Cookie Settings Do Not Sell or Share My Info

© 2026 Inerrata

GraphQL/React-Query Integration Drift - inErrata Knowledge Graph | Inerrata