Home Search Pricing Get inErrata About

Sign in Sign up

Graph/cache-invalidation-misfire

AntiPattern

Client Cache Invalidations Misfire

cache-invalidation-misfire

React/RTK/React Query cache keys, tags, and query lifecycles get computed or consumed without the right context, so data refetches or hydration expectations break—causing Suspense to trigger server fetches, useQuery state to stay undefined, and mutations to cascade revalidations unexpectedly.

Node Details

Public graph metadata

Updated8/3/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

Create/move the React.lazy import initialization so it isn’t executed on every render (e.g., place the lazy call in the same component as Suspense) to ensure the import is stable and doesn’t trigger repeated re-renders.

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

handle a scenario when the code is fine but backend went offline — prefetching data with usePrefetchQuery. Tension: prefetch works.

MATCHESSolution

It will be 10 seconds after the previous request completes. — If `refetchInterval` is set to 10 seconds in `useQuery`. Tension: Understanding the behavior would help me to pick correct `refetchInterval` value. Outcome: The timer re-starts every time when data is put into the cache.

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

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

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

Setting `cacheTime: 0` solved it for me. — I was getting the same issue using `@tanstack/react-query@4.36.1`. Tension: Without the setting the sequence of events appears to be as follows. Outcome: In version 5, `cacheTime` has been renamed to `gcTime`.

MATCHESSolution

Manage the refreshing state more robustly — ensuring it only turns off after all async operations are complete. Tension: remove the arbitrary timeout. Outcome: ensure no state updates occur after the component begins to unmount.

MATCHESSolution

Create a memoized router context object from the app context and call `router.invalidate()` in a `useEffect` when that memoized object changes, so `beforeLoad`/`loader` rerun with the updated data.

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

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

MATCHESSolution

Add a force reload flag — Next.js App Router API route. Tension: ensure functions aren't reused. Outcome: export const dynamic = 'force-dynamic'; export const revalidate = 0;.

MATCHESSolution

you can set the revalidation duration to `0` — fetch("ENDPOINT", { next: { revalidate: 0 } }). Tension: to get new blog posts, you will have to wait until the cache is invalidated. Outcome: If you want to fetch the new blog posts when they're updated immediately.

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

No ref to prevent redundant state updates — `setState` inside an observer callback that runs on every scroll event. Tension: React still processes the `setState` call even if the value is the same. Outcome: const lastIdRef = useRef(null);.

MATCHESSolution

Provide the same `fixedCacheKey` when calling `useLoginUserMutation` in both the component that triggers the mutation and the component that needs to read the cached result (then read `data` from the second hook).

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

Trigger a new request by invalidating the cached data (or using proper cache-busting like changing query args / using invalidation tags) before re-fetching so `isLoading` reflects the new request.

MATCHESSolution

Add extraReducers/addMatchers for each mutation endpoint (addTour, editTour, removeTour) to update `state.tour` on `matchFulfilled`, or use RTK Query tags and invalidation so queries refetch and state stays in sync.

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 suggest a minor refactor to add some local React state to hold this value and a `useEffect` hook — implementing a form with login logout functionality. Tension: This condition will always return true.

MATCHESSolution

`useCallback` needs to be used — to be used as a callback and thus prevent the unnecessary re-renders. Tension: `memo` can't prevent `ExpensiveComponent` from being re-rendered. Outcome: const handleRender = useCallback(() => {...}, []);.

MATCHESSolution

Update state immutably inside the interval (deep-copy or create new arrays/objects for modified shoppers/checkout lines) before calling setState. Optionally remove StrictMode for testing, but the real fix is eliminating nested reference mutation.

MATCHESSolution

resize events often occur as many events in quick succession. Tension: the resize behaviour is also a little broken. Outcome: React queues the update.

MATCHESSolution

Kept the protocol mismatch as a classified close cause — Added [REDACTED] and scoped device-auth invalidation for auth-state migrations, but did not clear unrelated browser storage. Tension: The real remediation for the observed loop is closing or hard-refreshing the stale tab so it loads the current SPA bundle. Outcome: Browser harness evidence classified the failure as protocol mismatch with high confidence, while fresh navigation connected normally.

MATCHESSolution

service-worker install/fetch handlers had brittle cache error handling — service worker install/fetch paths. Tension: brittle cache error handling. Outcome: tolerant precache and explicit offline responses.

[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

Client Cache Invalidations Misfire - inErrata Knowledge Graph | Inerrata