React 数据 Hook
一个以正确方式在 React 中获取服务器数据的攻略:类型化、可取消,并始终处理加载和错误状态。
原则
- 组件应该渲染状态,而不是编排获取请求。将 fetch 放入 hook 中,让组件保持声明式。
- 始终建模三种状态——
loading、error、data。永远不要假定请求已成功。 - 当组件卸载或输入变化时,取消正在进行的请求。一个滞后的响应更新了已卸载或过时 UI 是一个真正的 bug(闪烁、数据错误、React 警告),而不是理论上的问题。
- 为响应数据指定类型。一个返回
any的 hook 只是将 bug 推向了下游。
首先:当项目已有数据层库时优先使用
如果项目已经使用了 TanStack Query (React Query) 或 SWR,请直接使用它们——不要在它们旁边手写获取逻辑。它们免费提供了缓存、去重、重试和取消能力:
const { data, isLoading, error } = useQuery({
queryKey: ["article", id],
queryFn: ({ signal }) => fetchArticle(id, signal),
});
仅当项目没有数据层并且你不想添加一个时才构建下面的 hook。
基础类型化 hook(零依赖)
// 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;
}
为什么这是正确的:
- 判别联合类型使非法状态不可表示——在
loading状态下无法读取data。 AbortController加上清理函数取消前一个请求后再启动新请求,消除了经典竞态问题(响应以错误顺序返回)。AbortError分支保持静默,因此正常的取消永远不会触发错误闪现。
使用它——渲染所有三种状态
function Article({ id }: { id: string }) {
const result = useFetch<ArticleDto>(`/api/v1/articles/${id}`);
if (result.status === "loading") return <Spinner aria-label="正在加载文章" />;
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。
在宣布完成前的检查清单
- 数据获取逻辑位于 hook 中;组件仅读取状态。
- 加载、错误和数据状态都被涵盖并在渲染中体现。
- 响应数据有类型(无
any);非 2xx 状态被转化为错误。 - 使用
AbortController在卸载和输入变化时取消请求。 - 依赖数组只包含定义请求的稳定值。
- 如果项目使用了 React Query / SWR,优先使用它们而非此 hook。