React / 系统课时
加载错误与空状态
加载错误与空状态
异步请求不是只有“有数据”和“没数据”两种结果。一个可用的界面必须明确区分加载中、请求失败、成功但为空、成功且有数据四种状态,并让每种状态都有稳定、可预测的渲染结果。
学习目标
- 用互斥条件组织加载、失败、空数据和成功界面
- 避免把“空数组”误判为请求失败或仍在加载
- 为每种请求状态设计可验证的用户反馈
先把四种状态拆开
请求开始时进入加载态;请求抛错时进入失败态;请求成功但结果集合长度为 0 时进入空状态;只有请求成功且数据非空时才渲染内容。四种状态最好互斥,这样组件不会同时显示“加载中”和“暂无数据”等冲突信息。

关键点是“空”属于成功结果,而不是错误。后端返回 []、空搜索结果或用户还没有创建任何记录,都应该由空状态解释发生了什么,并给出下一步操作。
用一个组件覆盖所有状态
下面的示例用一个可控的异步函数模拟四种结果,便于直接验证渲染逻辑。真实项目中只需要把 loadUsers 替换为 fetch 或请求库调用,状态判定方式保持不变。
jsx
import { useState } from "react";
function loadUsers(mode) {
return new Promise((resolve, reject) => {
setTimeout(() => {
if (mode === "error") {
reject(new Error("服务暂时不可用"));
return;
}
resolve(mode === "empty" ? [] : [{ id: 1, name: "Ada" }]);
}, 600);
});
}
export default function App() {
const [users, setUsers] = useState([]);
const [loading, setLoading] = useState(false);
const [error, setError] = useState("");
async function handleLoad(mode) {
setLoading(true);
setError("");
try {
const data = await loadUsers(mode);
setUsers(data);
} catch (err) {
setUsers([]);
setError(err.message);
} finally {
setLoading(false);
}
}
let content;
if (loading) {
content = <p>正在加载...</p>;
} else if (error) {
content = <p role="alert">加载失败:{error}</p>;
} else if (users.length === 0) {
content = <p>暂无用户数据</p>;
} else {
content = <ul>{users.map((user) => <li key={user.id}>{user.name}</li>)}</ul>;
}
return (
<main>
<button onClick={() => handleLoad("success")}>成功</button>
<button onClick={() => handleLoad("empty")}>空数据</button>
<button onClick={() => handleLoad("error")}>失败</button>
{content}
</main>
);
}预期结果
text
点击“成功”:先显示“正在加载...”,约 600 ms 后显示 Ada。
点击“空数据”:先显示“正在加载...”,约 600 ms 后显示“暂无用户数据”。
点击“失败”:先显示“正在加载...”,约 600 ms 后显示“加载失败:服务暂时不可用”。实际延迟会因实现不同而变化;这里的 600 ms 只是为了让状态切换更容易观察。
让状态切换保持一致
每次发起新请求前应先清空旧错误,否则上一次失败信息可能在新请求加载时继续显示。失败时是否清空旧数据要按产品需求决定:列表页通常清空并显示错误更直观,而后台刷新场景可能希望保留旧数据并额外提示“刷新失败”。
避免布尔状态互相打架
loading、error 和 users 很直观,但状态越来越多时,多个布尔值可能组合出不可能出现的情况。此时可以改用单一状态值,例如 idle、loading、success、error,再把空数据作为 success 下的一个分支。
无论使用哪种写法,核心都不是“多写几个 if”,而是保证任何时刻只有一个主要界面状态生效,并让请求成功但无数据成为一等状态。
按自己的节奏,确认真正理解。