React / 系统课时
发起数据请求
发起数据请求
本课将完成一个最小数据请求页面:组件挂载后调用后端接口,把 JSON 结果保存到状态,并渲染为文章列表,同时明确 useEffect 中发起异步请求的正确写法。
学习目标
- 使用
fetch请求 JSON 接口 - 在
useEffect中控制请求触发时机 - 将接口结果保存到状态并渲染列表
明确接口约定
示例假设后端提供 GET /api/articles,响应状态为 200,响应体是文章数组:
[
{
"id": 1,
"title": "学习 React 数据请求"
},
{
"id": 2,
"title": "理解组件副作用"
}
]这是接口数据结构,不是控制台输出。前端至少依赖 id 和 title 两个字段;若真实接口字段不同,应先在请求层完成转换。
在组件挂载后请求数据
useEffect 的回调本身不要声明为 async,因为 Effect 回调只能返回清理函数或不返回内容。可以在 Effect 内部定义异步函数,再立即调用。
// 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>
);
}预期结果
接口成功时,页面显示两条文章标题。
接口返回非 2xx 状态时,页面显示“请求失败:<STATUS>”。<STATUS> 是后端实际返回的 HTTP 状态码。response.ok 只在状态码为 200 至 299 时为 true;fetch 遇到 404 或 500 不会自动抛出异常,因此必须主动检查。
理解依赖数组
空依赖数组 [] 表示该 Effect 在组件挂载后执行。开发环境启用 StrictMode 时,React 可能额外执行一次挂载流程来帮助发现副作用问题,因此后端写接口不应依赖“前端一定只调用一次”。
如果请求依赖路由参数,应把参数加入依赖数组:
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 后再传回同一引用。需要追加分页结果时,可以根据旧状态创建新数组:
setArticles((current) => [...current, ...nextPage]);这是片段示例,nextPage 代表接口返回的下一页数组。React 能通过新数组引用识别状态变化并重新渲染。
验证请求是否成功
除了观察页面,还应打开浏览器开发者工具的 Network 面板,确认请求方法、地址、状态码和响应体符合预期。若页面无数据,先确认接口是否成功,再检查字段名和列表渲染逻辑。