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”,而是保证任何时刻只有一个主要界面状态生效,并让请求成功但无数据成为一等状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

加载错误与空状态

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

登录哪都通