React / 系统课时

服务端状态与客户端状态

服务端状态与客户端状态

前端项目中的“状态”并不都应该用同一种方式管理。筛选条件、弹窗开关等通常由浏览器本地交互决定;商品列表、用户资料等则来自远端,并伴随加载、失败、过期和重新获取。先区分这两类状态,才能决定该用本地 state、框架数据层还是查询缓存。

学习目标

  • 根据数据来源和生命周期区分服务端状态与客户端状态
  • 识别服务端状态特有的加载、错误、过期和重新获取问题
  • 在同一组件中让远端数据与本地交互状态各自承担清晰职责

先按“事实来源”分类

客户端状态的事实来源通常就在当前前端应用中,例如当前选中的标签、表单草稿、侧边栏是否展开。更新它们通常是同步的,组件可以直接决定新值。

服务端状态的事实来源在远端系统。前端拿到的只是某个时刻的副本,因此除了“值是什么”,还要回答“是否正在加载”“是否获取失败”“这份数据是否过期”“什么时候需要重新获取”。

维度 客户端状态 服务端状态
事实来源 当前前端应用 API、数据库或其他远端系统
常见例子 弹窗、筛选条件、输入草稿 商品、订单、用户资料
更新特点 多为本地同步更新 常伴随异步请求
额外问题 组件作用域、持久化 加载、错误、缓存、失效、重试
常见工具 useState、useReducer 框架数据获取、查询缓存、必要时 Effect

区分的核心不是“数据是否存在 React state 中”,而是谁拥有最终事实。即使把接口响应暂存在 useState 里,它仍然是服务端状态,因为真正权威的数据仍在远端。

一个页面可以同时拥有两类状态

下面示例用一个延迟 Promise 模拟远端商品接口。productsState 表示服务端状态快照,包含加载生命周期;filter 只是当前页面的本地筛选条件。真实项目中可把 fetchProducts 换成 HTTP 请求。

js
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>
  );
}

预期结果

text
页面先显示“加载中...”
约 300 毫秒后显示 Keyboard 和 Mouse
点击“仅在售”后只显示 Keyboard
切换筛选条件不会重新执行 fetchProducts

这里的筛选条件只改变“怎样看当前数据”,不改变服务端数据本身。如果用户执行“删除商品”这类操作,就需要先把变更提交到远端,再更新或失效本地缓存,而不是只从当前数组中永久删掉一项并假设服务器已经同步。

为什么远端数据需要缓存语义

直接用 useEffect 和 useState 获取数据适合小型示例,但规模增大后会迅速出现重复请求、竞态、缓存复用、重新验证和错误重试等问题。此时更适合使用框架的数据获取机制或查询缓存工具,把“远端数据副本的生命周期”交给专门的数据层。

查询缓存通常会按查询键识别一份远端数据,并记录加载状态、缓存值和新鲜度。组件关注“我要哪份数据”,缓存层负责“是否已有可复用结果、何时重新请求、请求完成后哪些订阅者要更新”。

别把两类状态强行合并

一个常见误区是创建巨大的 reducer,同时存放 modalOpen、selectedTab、products、productsLoading 和 productsError。这样虽然“看起来统一”,却把本地交互状态与远端缓存生命周期耦合在一起,后续的重新获取、失效和并发请求会让 reducer 越来越复杂。

更清晰的划分是:本地交互状态由组件、Context 或 reducer 管理;远端状态由框架数据层或查询缓存管理;只有确实需要两者协同时,组件再把它们组合起来。例如服务端返回商品列表,本地 filter 决定当前显示子集,两者职责互不替代。

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

目录与阅读设置

阅读设置

17

记录一个想法

服务端状态与客户端状态

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

登录哪都通