React / 系统课时

状态边界与持久化

状态边界与持久化

本课建立一套可执行的状态归类方法,并用 Zustand persist 选择性保存主题和工作区。完成后,你能判断数据应放在组件、URL、服务端缓存还是全局 Store,也能避免把敏感或短期状态写入本地存储。

学习目标

  • 按生命周期、所有权和共享范围划分状态
  • 识别适合进入 URL 与服务端缓存的数据
  • 使用 partialize 只持久化必要的全局字段

用三个问题确定状态归属

判断状态位置时,先问三个问题:它由浏览器还是服务器拥有;是否需要被分享、收藏或通过前进后退恢复;刷新页面后是否仍应保留。不要先选工具再迁就数据,而要先确认状态的所有权和生命周期。

React 状态边界决策图

四类状态的最小边界

状态位置 适合的数据 判断依据
组件状态 输入框内容、弹窗开关、局部校验结果 只服务当前组件或局部组件树
URL 状态 搜索词、筛选条件、排序方式、页码 需要分享链接、刷新恢复或浏览器历史
服务端缓存 用户列表、订单详情、统计结果 数据由服务器拥有,可能过期并需要重新获取
全局状态 主题、当前工作区、跨页面临时草稿 客户端拥有,且多个远距离组件共同使用

服务端状态通常需要请求去重、失效判断、后台刷新和缓存回收,这些职责与普通客户端状态不同。TanStack Query 官方文档也将其定位为服务端状态管理工具,而不是所有全局状态的替代品。:contentReference[oaicite:2]{index=2}

URL 状态应直接编码在路径参数或查询参数中。React Router 提供 URL 参数和搜索参数接口,使筛选条件能随导航保存,而不是额外复制到 Zustand 后再手工同步。:contentReference[oaicite:3]{index=3}

选择性持久化 Store

Zustand 的 persist 中间件可以把状态写入浏览器存储,partialize 用于过滤真正需要保存的字段。:contentReference[oaicite:4]{index=4} 示例只持久化主题和工作区,不保存访问令牌与页面草稿。

在 React 18 与 TypeScript 项目中安装并确认依赖:

bash
npm install zustand
npm ls zustand --depth=0

预期输出如下,实际路径和版本号可能不同:

text
<PROJECT_NAME>@<VERSION> <PATH>
└── zustand@<VERSION>

将 src/App.tsx 替换为下面的完整浏览器端示例:

tsx
import { create } from 'zustand'
import { createJSONStorage, persist } from 'zustand/middleware'

type Theme = 'light' | 'dark'

interface PreferenceState {
  theme: Theme
  selectedWorkspaceId: string | null
  accessToken: string | null
  pageDraft: string
  toggleTheme: () => void
  selectWorkspace: (id: string) => void
  setAccessToken: (token: string | null) => void
  setPageDraft: (value: string) => void
}

// persist 负责恢复白名单字段,其他字段仍只存在于内存
const usePreferenceStore = create<PreferenceState>()(
  persist(
    (set) => ({
      theme: 'light',
      selectedWorkspaceId: null,
      // 敏感会话与短期草稿不应默认写入浏览器存储
      accessToken: null,
      pageDraft: '',
      toggleTheme: () =>
        set((state) => ({
          theme: state.theme === 'light' ? 'dark' : 'light',
        })),
      selectWorkspace: (id) => set({ selectedWorkspaceId: id }),
      setAccessToken: (token) => set({ accessToken: token }),
      setPageDraft: (value) => set({ pageDraft: value }),
    }),
    {
      // 固定键名便于检查、升级与清理持久化数据
      name: 'anystack-preferences',
      storage: createJSONStorage(() => localStorage),
      // 只保存刷新后仍需要、且可安全暴露的字段
      partialize: (state) => ({
        theme: state.theme,
        selectedWorkspaceId: state.selectedWorkspaceId,
      }),
    },
  ),
)

export default function App() {
  // 组件仍按字段订阅,不因持久化而改为读取整个 Store
  const theme = usePreferenceStore((state) => state.theme)
  const workspaceId = usePreferenceStore(
    (state) => state.selectedWorkspaceId,
  )
  const pageDraft = usePreferenceStore((state) => state.pageDraft)
  const accessToken = usePreferenceStore((state) => state.accessToken)
  const toggleTheme = usePreferenceStore((state) => state.toggleTheme)
  const selectWorkspace = usePreferenceStore(
    (state) => state.selectWorkspace,
  )
  const setPageDraft = usePreferenceStore((state) => state.setPageDraft)
  const setAccessToken = usePreferenceStore(
    (state) => state.setAccessToken,
  )

  return (
    <main style={{ padding: 24 }}>
      <p>主题:{theme}</p>
      <p>工作区:{workspaceId ?? '未选择'}</p>
      <p>令牌:{accessToken ?? '无'}</p>
      <button onClick={toggleTheme}>切换主题</button>
      <button onClick={() => selectWorkspace('workspace-1001')}>
        选择工作区
      </button>
      <button onClick={() => setAccessToken('temporary-token')}>
        写入临时令牌
      </button>
      <input
        value={pageDraft}
        placeholder="输入临时草稿"
        onChange={(event) => setPageDraft(event.target.value)}
      />
    </main>
  )
}

预期结果:

text
操作前:theme=light,selectedWorkspaceId=null,accessToken=null,pageDraft=""。
操作并刷新前:主题、工作区、临时令牌和草稿都显示新值。
刷新页面后:主题和工作区保持不变;临时令牌恢复为 null,草稿恢复为空字符串。
localStorage 中只保存 theme 与 selectedWorkspaceId。

持久化的安全与生命周期边界

持久化并不等于“更可靠”。localStorage 中的数据可被浏览器端脚本读取,也可能因结构升级而失效,因此不要默认保存访问令牌、支付信息、完整用户资料或一次性表单内容。敏感会话优先由后端会话与安全 Cookie 方案管理。

只保存可恢复的偏好和标识,而不是保存可由服务器重新获取的完整对象。例如保存 selectedWorkspaceId,刷新后再按 ID 请求工作区详情;不要把工作区名称、权限和成员列表一起长期复制到本地。

当持久化结构发生变化时,应增加版本与迁移策略;在支持服务端渲染的项目中,还要把浏览器存储读取限制在客户端,并处理首次渲染与恢复后的状态差异。

验收清单

  • 搜索、筛选和页码能够通过 URL 复制给其他人。
  • 列表与详情仍由服务端缓存管理,没有重复存入 Zustand。
  • 刷新后只恢复主题、工作区等必要偏好。
  • localStorage 中不存在令牌、敏感资料和可重新请求的大对象。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

状态边界与持久化

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

登录哪都通