댓글을 달면 바로 보이게, TanStack Query로 해 둔 낙관적 업데이트를 useOptimistic과 비교해 봤습니다
이 블로그의 댓글은 TanStack Query의 onMutate와 롤백으로 낙관적 업데이트를 하고 있습니다. 같은 동작을 React 19의 useOptimistic으로 다시 써 보면서 줄어드는 코드와 새로 신경 써야 할 부분을 비교했습니다.
React 19 다시 배우기· 2 / 4펼치기접기
- 1. pending과 error를 useState로 들고 있던 로그인 폼, React 19 Actions로 다시 써 보기
- 2. 댓글을 달면 바로 보이게, TanStack Query로 해 둔 낙관적 업데이트를 useOptimistic과 비교해 봤습니다
- 3. getState()로 최신 값을 꺼내던 useEffect, use와 useEffectEvent로 덜어내기
- 4. useMemo를 지워도 될까요, 이 블로그에 React Compiler를 켜고 빌드해 봤습니다
댓글을 쓰고 등록 버튼을 눌렀는데 1초쯤 아무 변화가 없으면, 한 번 더 누르게 됩니다. 그래서 이 블로그의 댓글은 서버 응답을 기다리지 않고 화면에 먼저 붙이고, 실패하면 되돌리는 낙관적 업데이트(optimistic update)로 만들어 두었습니다. 구현은 TanStack Query의 useMutation으로 했습니다.
React 19에는 이 일을 하라고 만든 useOptimistic 훅이 있습니다. 이 글에서는 실제 댓글 코드를 useOptimistic으로 다시 써 보고, 두 방식이 어디서 갈리는지 정리합니다. 1편과 마찬가지로 블로그 코드는 아직 바꾸지 않았습니다.
1. 지금은 캐시를 직접 고치고 되돌립니다
src/components/Comments.tsx에서 낙관적 업데이트에 해당하는 부분은 이렇습니다.
const optimistic = (apply: (list: Comment[]) => Comment[]) => async () => {
await qc.cancelQueries({ queryKey: key });
const prev = qc.getQueryData<Comment[]>(key);
qc.setQueryData<Comment[]>(key, (old) => apply(old ?? []));
return { prev };
};
const rollback = (_e: unknown, _v: unknown, ctx?: { prev?: Comment[] }) => qc.setQueryData(key, ctx?.prev);
const settle = () => qc.invalidateQueries({ queryKey: key });
const add = useMutation({
mutationFn: async (v: { body: string; parent_id: string | null }) => {
const { error } = await db.from("comments").insert({ post_id: postId, user_id: me.data!.id, ...v });
if (error) throw error;
},
onMutate: (v) => optimistic((list) => [...list, { id: `temp-${Date.now()}`, ...v /* 나머지 필드 */ }])(),
onError: rollback,
onSettled: settle,
});순서는 TanStack Query 문서에 나오는 그대로입니다. 진행 중인 조회를 취소하고, 이전 값을 스냅숏으로 떠 두고, 캐시를 고친 다음, 실패하면 스냅숏으로 되돌리고, 끝나면 서버 값으로 다시 맞춥니다. 작성과 삭제 두 군데에서 같은 순서를 반복해야 해서 optimistic, rollback, settle이라는 작은 함수로 묶어 두었습니다.
2. useOptimistic은 되돌리는 일을 하지 않아도 됩니다
useOptimistic은 기준이 되는 상태와, 그 위에 임시 변경을 얹는 함수를 받습니다.
const [shown, addOptimistic] = useOptimistic(state, (current, change) => next);액션이 실행되는 동안에는 shown이 임시 변경이 얹힌 값이고, 액션이 끝나면 shown은 다시 state를 그대로 보여 줍니다. 그래서 실패했을 때 되돌릴 필요가 없습니다. 임시 값은 액션이 끝나는 순간 저절로 사라지고, 그때 state가 서버 값으로 바뀌어 있으면 그 값이, 안 바뀌었으면 원래 값이 보입니다.
스냅숏을 뜨고 롤백하는 코드가 통째로 없어진다는 점이 처음엔 신기했습니다. 생각해 보면 "진짜 상태는 건드리지 않고 화면에만 덧칠한다"는 발상이라 되돌릴 것이 애초에 없는 거죠.
3. 같은 댓글을 다시 썼습니다
조회는 그대로 TanStack Query에 맡기고, 작성과 삭제만 useOptimistic으로 바꿔 봤습니다.
type Change = { type: "add"; comment: Comment } | { type: "remove"; id: string };
const list = comments.data ?? [];
const [shown, apply] = useOptimistic(list, (current: Comment[], c: Change) =>
c.type === "add"
? [...current, c.comment]
: current.map((x) => (x.id === c.id ? { ...x, deleted_at: new Date().toISOString() } : x)),
);
const [, startTransition] = useTransition();
const [error, setError] = useState("");
function addComment(body: string, parent_id: string | null) {
startTransition(async () => {
apply({ type: "add", comment: { id: `temp-${Date.now()}`, body, parent_id /* 나머지 필드 */ } });
const { error } = await db.from("comments").insert({ post_id: postId, user_id: me.data!.id, body, parent_id });
if (error) setError("댓글을 저장하지 못했습니다.");
await qc.invalidateQueries({ queryKey: key });
});
}화면에는 list 대신 shown을 그립니다. cancelQueries, getQueryData, setQueryData가 모두 빠졌고, 실패 처리는 메시지를 띄우는 한 줄만 남았습니다.
4. 액션이 끝나기 전에 서버 값을 받아 와야 깜빡이지 않습니다
다시 쓰면서 가장 오래 고민한 줄은 마지막의 await qc.invalidateQueries(...)입니다. useOptimistic의 임시 값은 액션이 끝나는 순간 사라집니다. 그런데 그 시점에 list가 아직 예전 목록이면, 방금 단 댓글이 잠깐 사라졌다가 다시 나타납니다.
그래서 액션 안에서 다시 조회하는 것까지 기다리게 했습니다. TanStack Query의 invalidateQueries는 활성 쿼리의 재조회가 끝날 때 resolve되는 Promise를 돌려주기 때문에, 이걸 await하면 새 목록이 캐시에 들어온 뒤에 액션이 끝납니다. 임시 값이 사라지는 순간 진짜 값이 이미 그 자리에 있는 셈입니다.
TanStack Query 방식에서는 이 문제가 없었습니다. 캐시 자체를 고쳐 두었기 때문에 재조회가 늦게 끝나도 화면은 그대로입니다. 두 방식의 차이가 가장 잘 드러나는 지점이라고 생각합니다.
5. 에러를 던지면 에러 바운더리까지 올라갑니다
useMutation의 mutationFn에서는 에러를 던지는 게 정상적인 흐름이었습니다. onError가 받아서 처리해 주니까요. 하지만 startTransition에 넘긴 액션에서 에러를 던지면, React는 그 에러를 가장 가까운 에러 바운더리(error boundary)로 보냅니다. 댓글 하나 저장에 실패했다고 글 전체가 에러 화면으로 바뀌면 곤란합니다.
그래서 위 코드에서는 Supabase가 돌려준 error를 던지지 않고 상태로만 남겼습니다. 하나 더 조심할 점은 await 다음에 부르는 setState입니다. React 문서에 따르면 await 뒤의 상태 변경은 전환으로 묶이지 않습니다. 에러 메시지는 바로 보이는 편이 오히려 좋아서 그대로 두었지만, 전환으로 처리하고 싶은 업데이트라면 startTransition으로 한 번 더 감싸야 합니다.
6. 공유되는 캐시가 있으면 TanStack Query 쪽이 맞습니다
비교해 보니 두 방식은 다루는 범위가 달랐습니다. useOptimistic의 임시 값은 그 컴포넌트 안에서만 보입니다. 반면 TanStack Query로 캐시를 고치면, 같은 쿼리 키를 쓰는 다른 컴포넌트도 바뀐 값을 함께 봅니다. 예를 들어 헤더에 "내 댓글 수"를 따로 보여 주는 컴포넌트가 있었다면, useOptimistic만으로는 그쪽 숫자가 같이 오르지 않습니다.
TanStack Query v5에는 그 중간쯤 되는 방법도 있습니다. 캐시를 고치지 않고 useMutation이 돌려주는 variables와 isPending으로 화면에만 임시 항목을 그리는 방식인데, 문서에서는 이를 UI를 통한 낙관적 업데이트라고 소개합니다. 발상은 useOptimistic과 거의 같습니다.
이 블로그의 댓글 목록은 Comments 컴포넌트 안에서만 쓰입니다. 그래서 useOptimistic으로 바꿔도 잃는 것이 없다는 판단은 섰고, 실제로 바꾸는 일은 앞으로 해 볼 일로 남겨 두었습니다.
마치며
처음엔 useOptimistic이 TanStack Query를 대신하는 도구라고 생각했습니다. 하지만 써 보니 서버 상태를 관리하는 도구가 아니라, 진행 중인 액션 동안 화면에 덧칠을 하는 도구였습니다. 서버 값은 여전히 누군가 가져와야 하고, 그 값이 제때 도착해야 깜빡이지 않습니다.
롤백 코드를 지울 수 있다는 건 분명한 장점이었습니다. 다음 글에서는 이 블로그 코드 곳곳에 있는 useEffect를 use와 useEffectEvent로 줄일 수 있는지 살펴보겠습니다.
Comments (0)