React / 系统课时

发起数据请求

发起数据请求

本课将完成一个最小数据请求页面:组件挂载后调用后端接口,把 JSON 结果保存到状态,并渲染为文章列表,同时明确 useEffect 中发起异步请求的正确写法。

学习目标

  • 使用 fetch 请求 JSON 接口
  • 在 useEffect 中控制请求触发时机
  • 将接口结果保存到状态并渲染列表

明确接口约定

示例假设后端提供 GET /api/articles,响应状态为 200,响应体是文章数组:

json
[
  {
    "id": 1,
    "title": "学习 React 数据请求"
  },
  {
    "id": 2,
    "title": "理解组件副作用"
  }
]

这是接口数据结构,不是控制台输出。前端至少依赖 id 和 title 两个字段;若真实接口字段不同,应先在请求层完成转换。

在组件挂载后请求数据

useEffect 的回调本身不要声明为 async,因为 Effect 回调只能返回清理函数或不返回内容。可以在 Effect 内部定义异步函数,再立即调用。

jsx
// src/ArticleList.jsx
import { useEffect, useState } from "react";

export default function ArticleList() {
  const [articles, setArticles] = useState([]);
  const [errorMessage, setErrorMessage] = useState("");

  useEffect(() => {
    async function loadArticles() {
      try {
        const response = await fetch("/api/articles");

        if (!response.ok) {
          throw new Error(`请求失败:${response.status}`);
        }

        const result = await response.json();
        setArticles(result);
      } catch (error) {
        setErrorMessage(error instanceof Error ? error.message : "未知错误");
      }
    }

    loadArticles();
  }, []);

  if (errorMessage) {
    return <p role="alert">{errorMessage}</p>;
  }

  return (
    <section>
      <h2>文章列表</h2>
      <ul>
        {articles.map((article) => (
          <li key={article.id}>{article.title}</li>
        ))}
      </ul>
    </section>
  );
}

预期结果

text
接口成功时,页面显示两条文章标题。
接口返回非 2xx 状态时,页面显示“请求失败:<STATUS>”。

<STATUS> 是后端实际返回的 HTTP 状态码。response.ok 只在状态码为 200 至 299 时为 true;fetch 遇到 404 或 500 不会自动抛出异常,因此必须主动检查。

理解依赖数组

空依赖数组 [] 表示该 Effect 在组件挂载后执行。开发环境启用 StrictMode 时,React 可能额外执行一次挂载流程来帮助发现副作用问题,因此后端写接口不应依赖“前端一定只调用一次”。

如果请求依赖路由参数,应把参数加入依赖数组:

jsx
useEffect(() => {
  async function loadArticle() {
    const response = await fetch(`/api/articles/${articleId}`);
    const result = await response.json();
    setArticle(result);
  }

  loadArticle();
}, [articleId]);

这是片段示例,依赖组件中已定义的 articleId、article 和 setArticle。当 articleId 改变时会重新请求对应文章。

避免直接修改请求结果

状态更新应传入新值,不要对已有数组执行 push 后再传回同一引用。需要追加分页结果时,可以根据旧状态创建新数组:

jsx
setArticles((current) => [...current, ...nextPage]);

这是片段示例,nextPage 代表接口返回的下一页数组。React 能通过新数组引用识别状态变化并重新渲染。

验证请求是否成功

除了观察页面,还应打开浏览器开发者工具的 Network 面板,确认请求方法、地址、状态码和响应体符合预期。若页面无数据,先确认接口是否成功,再检查字段名和列表渲染逻辑。

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

目录与阅读设置

阅读设置

17

记录一个想法

发起数据请求

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

登录哪都通