📌 setQueryData가 데이터를 fresh로 만드는 이유

💡 1️⃣ React Query의 기본 원칙

"캐시에 있는 데이터는 신뢰할 수 있는 최신 데이터여야 한다."

• setQueryData를 호출했다는 것은, 개발자가 의도적으로 최신 데이터라고 간주하는 데이터를 캐시에 직접 넣었다는 의미입니다.
• React Query는 "개발자가 직접 넣은 데이터니까 최신 데이터다!"라고 판단하고, 해당 쿼리를 fresh 상태로 변경합니다.

💡 2️⃣ fresh와 stale의 의미

• setQueryData → 개발자가 최신 데이터라고 직접 주입
• React Query → "이건 믿을만한 최신 데이터니까 fresh 처리!"

💡 3️⃣ setQueryData는 주로 낙관적 업데이트용

• 보통 서버 요청 전에 UI를 먼저 업데이트할 때 setQueryData를 사용합니다.
• 즉, 개발자가 "이 정도면 서버랑 맞을 거야"라고 판단하고 업데이트하는 흐름.
• React Query는 "개발자가 최신 데이터라고 보장했으니, fresh로 간주해도 되겠지"라고 해석합니다.

💡 4️⃣ staleTime보다 setQueryData가 우선

• 기존 쿼리의 staleTime 설정과 관계없이
• setQueryData를 하면 → 즉시 fresh 처리
• staleTime은 그 시점부터 다시 카운트

⚠️ 개발자 보증 데이터 = fresh 철학의 함정

• setQueryData로 넣은 데이터가 실제로 최신이 아닐 수도 있음
• 여러 화면에서 데이터 공유 시, 다른 화면이 setQueryData로 변경한 데이터를 "fresh니까 믿을만해"라고 오판할 가능성
• 이런 문제를 방지하려면, invalidateQueries로 명확히 stale 처리하는 것이 안전

📊 요점 정리

📢 정리

✅ 결론

setQueryData = 개발자가 "이거 믿을 수 있어!" 하고 직접 넣은 데이터
React Query = "개발자가 넣었으니까 최신 데이터로 간주하고 fresh 처리"

📚 참고 문서

• Optimistic Updates (Tanstack Query 공식 문서)