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 函数,但保留状态模型、取消逻辑和重试入口。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

加载状态与请求错误

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通