React / 系统课时
服务端状态与客户端状态
服务端状态与客户端状态
前端项目中的“状态”并不都应该用同一种方式管理。筛选条件、弹窗开关等通常由浏览器本地交互决定;商品列表、用户资料等则来自远端,并伴随加载、失败、过期和重新获取。先区分这两类状态,才能决定该用本地 state、框架数据层还是查询缓存。
学习目标
- 根据数据来源和生命周期区分服务端状态与客户端状态
- 识别服务端状态特有的加载、错误、过期和重新获取问题
- 在同一组件中让远端数据与本地交互状态各自承担清晰职责
先按“事实来源”分类
客户端状态的事实来源通常就在当前前端应用中,例如当前选中的标签、表单草稿、侧边栏是否展开。更新它们通常是同步的,组件可以直接决定新值。
服务端状态的事实来源在远端系统。前端拿到的只是某个时刻的副本,因此除了“值是什么”,还要回答“是否正在加载”“是否获取失败”“这份数据是否过期”“什么时候需要重新获取”。
| 维度 | 客户端状态 | 服务端状态 |
|---|---|---|
| 事实来源 | 当前前端应用 | API、数据库或其他远端系统 |
| 常见例子 | 弹窗、筛选条件、输入草稿 | 商品、订单、用户资料 |
| 更新特点 | 多为本地同步更新 | 常伴随异步请求 |
| 额外问题 | 组件作用域、持久化 | 加载、错误、缓存、失效、重试 |
| 常见工具 | useState、useReducer |
框架数据获取、查询缓存、必要时 Effect |
区分的核心不是“数据是否存在 React state 中”,而是谁拥有最终事实。即使把接口响应暂存在 useState 里,它仍然是服务端状态,因为真正权威的数据仍在远端。
一个页面可以同时拥有两类状态
下面示例用一个延迟 Promise 模拟远端商品接口。productsState 表示服务端状态快照,包含加载生命周期;filter 只是当前页面的本地筛选条件。真实项目中可把 fetchProducts 换成 HTTP 请求。
import { useEffect, useMemo, useState } from 'react';
function fetchProducts() {
return new Promise((resolve) => {
setTimeout(() => {
resolve([
{ id: 1, name: 'Keyboard', active: true },
{ id: 2, name: 'Mouse', active: false },
]);
}, 300);
});
}
export default function ProductPage() {
const [filter, setFilter] = useState('all');
const [productsState, setProductsState] = useState({
status: 'loading',
data: [],
error: null,
});
useEffect(() => {
let ignore = false;
fetchProducts()
.then((data) => {
if (!ignore) {
setProductsState({ status: 'success', data, error: null });
}
})
.catch((error) => {
if (!ignore) {
setProductsState({ status: 'error', data: [], error });
}
});
// 组件卸载后忽略已返回的异步结果,避免更新失效页面
return () => {
ignore = true;
};
}, []);
const visibleProducts = useMemo(() => {
if (filter === 'active') {
return productsState.data.filter((item) => item.active);
}
return productsState.data;
}, [filter, productsState.data]);
if (productsState.status === 'loading') return <p>加载中...</p>;
if (productsState.status === 'error') return <p>加载失败</p>;
return (
<section>
<button onClick={() => setFilter('all')}>全部</button>
<button onClick={() => setFilter('active')}>仅在售</button>
<p>当前筛选:{filter}</p>
<ul>
{visibleProducts.map((item) => (
<li key={item.id}>{item.name}</li>
))}
</ul>
</section>
);
}预期结果
页面先显示“加载中...”
约 300 毫秒后显示 Keyboard 和 Mouse
点击“仅在售”后只显示 Keyboard
切换筛选条件不会重新执行 fetchProducts这里的筛选条件只改变“怎样看当前数据”,不改变服务端数据本身。如果用户执行“删除商品”这类操作,就需要先把变更提交到远端,再更新或失效本地缓存,而不是只从当前数组中永久删掉一项并假设服务器已经同步。
为什么远端数据需要缓存语义
直接用 useEffect 和 useState 获取数据适合小型示例,但规模增大后会迅速出现重复请求、竞态、缓存复用、重新验证和错误重试等问题。此时更适合使用框架的数据获取机制或查询缓存工具,把“远端数据副本的生命周期”交给专门的数据层。
查询缓存通常会按查询键识别一份远端数据,并记录加载状态、缓存值和新鲜度。组件关注“我要哪份数据”,缓存层负责“是否已有可复用结果、何时重新请求、请求完成后哪些订阅者要更新”。
别把两类状态强行合并
一个常见误区是创建巨大的 reducer,同时存放 modalOpen、selectedTab、products、productsLoading 和 productsError。这样虽然“看起来统一”,却把本地交互状态与远端缓存生命周期耦合在一起,后续的重新获取、失效和并发请求会让 reducer 越来越复杂。
更清晰的划分是:本地交互状态由组件、Context 或 reducer 管理;远端状态由框架数据层或查询缓存管理;只有确实需要两者协同时,组件再把它们组合起来。例如服务端返回商品列表,本地 filter 决定当前显示子集,两者职责互不替代。