React 데이터 훅은(는) 무엇을 하나요?
React에서 서버 데이터를 올바르게 가져오기 위한 플레이북입니다: 타입 안전하고, 취소 가능하며, 항상 로딩 + 에러 상태를 처리합니다.
원칙
- 컴포넌트는 상태를 렌더링해야 하며, 가져오기를 조정해서는 안 됩니다. 가져오기는 훅에 넣어 컴포넌트가 선언형을 유지하세요.
- 항상 세 가지 상태 —
로딩,에러,데이터— 를 모델링하세요. 요청이 성공했다고 가정하지 마세요. - 컴포넌트가 언마운트되거나 입력이 변경될 때 진행 중인 요청을 취소하세요. 늦은 응답이 언마운트되거나 오래된 UI를 업데이트하면 실제 버그(깜빡임, 잘못된 데이터, React 경고)가 발생합니다. 이론적인 문제가 아닙니다.
- 응답에 타입을 지정하세요.
any를 반환하는 훅은 버그를 다운스트림으로 옮길 뿐입니다.
먼저: 실제 데이터 라이브러리가 있으면 우선 사용하세요
프로젝트가 이미 TanStack Query(React Query) 또는 SWR을 사용하고 있다면, 이를 사용하세요. 수작업으로 가져오기를 구현하지 마세요. 캐싱, 중복 제거, 재시도, 취소를 무료로 제공합니다:
const { data, isLoading, error } = useQuery({
queryKey: ["article", id],
queryFn: ({ signal }) => fetchArticle(id, signal),
});
아래 훅은 프로젝트에 데이터 계층이 없고 추가하고 싶지 않을 때만 빌드하세요.
기본 타입 훅 (의존성 없음)
// useFetch.ts
import { useEffect, useState } from "react";
type State<T> =
| { status: "loading"; data: null; error: null }
| { status: "success"; data: T; error: null }
| { status: "error"; data: null; error: Error };
export function useFetch<T>(url: string, init?: RequestInit): State<T> {
const [state, setState] = useState<State<T>>({
status: "loading",
data: null,
error: null,
});
useEffect(() => {
const controller = new AbortController();
setState({ status: "loading", data: null, error: null });
fetch(url, { ...init, signal: controller.signal })
.then(async (res) => {
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
return (await res.json()) as T;
})
.then((data) => setState({ status: "success", data, error: null }))
.catch((err: unknown) => {
if (err instanceof DOMException && err.name === "AbortError") return; // 예상된 동작
setState({
status: "error",
data: null,
error: err instanceof Error ? err : new Error(String(err)),
});
});
return () => controller.abort(); // 언마운트 / url 변경 시 취소
}, [url]); // 요청 식별자가 변경될 때만 재실행
return state;
}
올바른 이유:
- 식별된 유니온은 불법 상태를 표현 불가능하게 만듭니다. —
로딩중에는data를 읽을 수 없습니다. AbortController+ 정리 함수 반환은 새 요청을 시작하기 전 이전 요청을 취소하여, 응답이 순서에 맞지 않게 해결되는 고전적인 경쟁 상태를 제거합니다.AbortError분기는 조용히 처리되므로, 정상적인 취소가 에러를 표시하지 않습니다.
사용하기 — 세 가지 상태 모두 렌더링
function Article({ id }: { id: string }) {
const result = useFetch<ArticleDto>(`/api/v1/articles/${id}`);
if (result.status === "loading") return <Spinner aria-label="Loading article" />;
if (result.status === "error") return <ErrorBanner message={result.error.message} />;
return <ArticleView article={result.data} />;
}
로딩 및 에러 분기를 렌더링하는 것은 선택적인 장식이 아닙니다. 빈 화면과 사용 가능한 화면의 차이를 만듭니다.
이 스킬이 방지하는 일반적인 실수
useEffect(() => { fetch(url).then(r => r.json()).then(setData) }, [])— 로딩 상태 없음, 에러 처리 없음, 취소 없음,[]는 변경되는url을 무시합니다.- 의존성 배열에 안정적이지 않은 값(객체/배열 리터럴, 인라인
init)을 넣어 무한 리페치 루프 발생. 값들을 메모이제이션하거나 원시 값에 의존하세요. - 언마운트 후
setData가 실행됨. 정리 함수abort()는 늦은.then이AbortError에서 조기 종료되도록 만듭니다. - 2xx가 아닌 응답 무시 —
fetch는 네트워크 실패 시에만 거부하므로, 직접res.ok를 확인해야 합니다.
완료 전 체크리스트
- 가져오기는 훅에 있으며; 컴포넌트는 상태만 읽습니다.
- 로딩, 에러, 데이터가 모두 표현되고 모두 렌더링됩니다.
- 응답에 타입이 지정되었습니다(
any없음); 2xx가 아닌 응답은 에러로 변환됩니다. -
AbortController가 언마운트 및 입력 변경 시 취소합니다. - 의존성 배열에는 요청을 정의하는 안정적인 값만 포함됩니다.
- 프로젝트에 React Query / SWR이 있다면 이 훅 대신 사용됩니다.