React / 系统课时
加载状态与请求错误
加载状态与请求错误
本课将把一次数据请求拆成加载、成功、空数据和失败四种可见状态,并提供重试入口。完成后,页面不会在请求期间空白,也不会把空数组误判为异常。
学习目标
- 使用联合类型描述互斥的请求状态
- 在 React 组件中渲染加载、空数据、失败和成功界面
- 通过取消请求与重试避免过期响应覆盖新状态
先建立状态模型
请求状态不是几个彼此独立的布尔值。若同时维护 loading、error 和 data,很容易出现“正在加载但仍显示旧错误”之类的矛盾组合。
更稳妥的做法是使用可辨识联合类型,让组件在任意时刻只处于一种状态。正常请求从 loading 出发,随后进入 success、empty 或 error;点击重试后再回到 loading。

实现完整页面
下面的代码可直接替换 Vite React TypeScript 项目的 src/App.tsx。组件在卸载或重新请求时中止旧请求,避免较慢的旧响应覆盖新的页面状态。
tsx
import { useEffect, useState } from "react";
interface User {
id: number;
name: string;
}
type LoadState =
| { status: "loading" }
| { status: "success"; data: User[] }
| { status: "empty" }
| { status: "error"; message: string };
const ENDPOINT =
"https://jsonplaceholder.typicode.com/users?_limit=3";
export default function App() {
const [state, setState] = useState<LoadState>({
status: "loading",
});
const [retryKey, setRetryKey] = useState(0);
useEffect(() => {
const controller = new AbortController();
async function loadUsers() {
setState({ status: "loading" });
try {
const response = await fetch(ENDPOINT, {
signal: controller.signal,
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
const users = (await response.json()) as User[];
setState(
users.length === 0
? { status: "empty" }
: { status: "success", data: users },
);
} catch (error) {
// 主动取消不应显示为请求失败
if (controller.signal.aborted) {
return;
}
setState({
status: "error",
message:
error instanceof Error ? error.message : "未知错误",
});
}
}
void loadUsers();
return () => controller.abort();
}, [retryKey]);
if (state.status === "loading") {
return <p>加载中……</p>;
}
if (state.status === "empty") {
return <p>暂无用户数据</p>;
}
if (state.status === "error") {
return (
<section>
<p>加载失败:{state.message}</p>
<button onClick={() => setRetryKey((value) => value + 1)}>
重新加载
</button>
</section>
);
}
return (
<ul>
{state.data.map((user) => (
<li key={user.id}>{user.name}</li>
))}
</ul>
);
}预期结果:
text
页面先显示“加载中……”,请求成功后显示 3 个用户名称。将接口参数临时改为 _limit=0,页面应进入空数据状态;将地址改成不存在的资源并返回非 2xx 状态,页面应显示错误信息和“重新加载”按钮。
错误提示与重试边界
面向用户的提示应说明“发生了什么”和“下一步能做什么”,不要直接展示完整堆栈或后端内部信息。详细错误应写入日志或监控系统,页面只保留可理解的摘要。
重试适合网络抖动、读取超时和临时服务错误。登录失效、参数错误、权限不足等情况通常需要跳转登录、修正输入或申请权限,而不是反复发送同一请求。
验收检查
运行页面后,依次验证正常、空数据和失败三条路径。每次切换都应只有一个主状态可见,旧列表不能与加载提示同时出现,组件卸载后也不应再更新状态。
若项目已经使用统一 HTTP 客户端,应把示例中的 fetch 替换为业务 API 函数,但保留状态模型、取消逻辑和重试入口。
按自己的节奏,确认真正理解。