12.5 阶段 4 状态管理与数据层
本页目录
一、阶段定位
组件本地状态不够用时,需要跨组件共享的「全局状态」与「服务端数据缓存」。本阶段解决两件事:用 Zustand/Pinia 管客户端状态(登录态、主题、全局配置),用 TanStack Query/SWR 管服务端数据(拉取、缓存、失效、重试)。关键判断是——不要把所有数据都塞进全局 store,服务端数据应该交给请求库,本地状态才用 store。
不掌握本阶段会在后面具体卡在哪:
- 把列表数据、详情数据也写进 Zustand/Pinia,导致缓存与请求逻辑到处重复,数据过期了不知道怎么刷新。
- 多端共享登录态:刷新页面就丢,localStorage 读写散落各处,没有统一的拦截器。
- 列表翻页、筛选、分页参数状态混乱,URL 与状态不同步,分享链接无法还原页面。
- 并发请求没有去重,同一个接口切路由切回来重复打。
判断卡住的标志:让你设计「登录后全站拿到用户信息、请求自动带 token、401 跳登录」,你说不清 token 存哪、拦截器在哪写、用户信息放 store 还是 Context。出现任一现象,先把本阶段六个模块过一遍再进 阶段 5 构建工具链与工程化。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能用 Zustand/Pinia 建一个全局 store | 登录态在任意组件读写 |
| 能封装统一请求层(fetch/axios 实例 + 拦截器) | 自动带 token、统一错误处理 |
| 能用 TanStack Query 拉数据 | 自动缓存、失效、重新拉取 |
| 能区分服务端状态与客户端状态 | 不把接口数据塞进全局 store |
| 能把筛选/分页同步到 URL query | 刷新页面状态还原 |
| 能处理 401 跳登录与 token 刷新 | 过期自动跳登录页 |
建议学时:
- 全职:2 周,约 35 小时。状态库 8 小时、请求封装 8 小时、服务端状态库 10 小时、URL 同步与缓存策略 5 小时、练习 4 小时。
- 在职:4 周,约 40 小时。
三、先修自检
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| 阶段 3 产出 | 能写组件、useEffect 请求、Context | 回到 12.4 |
| TS 泛型 | 能写泛型函数 | 回到 12.3 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 客户端状态 | Zustand、Pinia、store 划分原则 | 能讲清原理 | 03.5 状态管理与路由 |
| 请求层 | fetch/axios 实例、请求/响应拦截器、错误模型 | 能讲清原理 | 03.6 前端工程化 |
| 服务端状态 | TanStack Query/SWR、缓存键、失效、重试、分页 | 会用 | 03.5 状态管理与路由 |
| URL 状态 | search params、路由同步、可分享链接 | 会用 | 03.5 状态管理与路由 |
| 认证 | token 存储位置、刷新机制、401 处理 | 能讲清原理 | 03.8 浏览器原理、性能优化与前端安全 |
五、分模块精讲
5.1 客户端状态库:Zustand / Pinia
为什么需要它:跨组件共享的简单状态(用户、主题、权限)用 Context 会引发不必要的全树重渲染,专用 store 用订阅选择器解决。
核心机制:
- Zustand(React 通用):一个 hook 既是 store 又是读取入口;
useStore(s => s.user)选择需要的字段,只有该字段变了才重渲染。 - Pinia(Vue 官方推荐,也可用于 React):按 store 模块化,
defineStore,state/getters/actions 三段式,devtools 友好。 - 划分原则:全局、跨页面、需要持久化的才进 store;组件私有状态留在组件里;服务端数据不进 store(交给请求库)。
最小可运行示例:
// stores/user.ts(Zustand)
import { create } from 'zustand'
import { persist } from 'zustand/middleware'
interface UserState {
token: string | null
user: { id: number; name: string } | null
setToken: (t: string) => void
logout: () => void
}
export const useUserStore = create<UserState>()(
persist(
(set) => ({
token: null,
user: null,
setToken: (t) => set({ token: t }),
logout: () => set({ token: null, user: null })
}),
{ name: 'auth' } // 持久化到 localStorage
)
)
// Pinia
import { defineStore } from 'pinia'
export const useUserStore = defineStore('user', {
state: () => ({ token: null as string | null }),
getters: { isLogin: (s) => !!s.token },
actions: {
setToken(t: string) { this.token = t },
logout() { this.token = null }
}
})
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 改了 store 组件不更新 | 没订阅选择器或直接改 state | 用 selector 或 action |
| 所有用到 store 的组件都重渲染 | 没拆分 store 或没选字段 | 按领域拆 store,用 selector |
面试考法:问 Redux 与 Zustand/Pinia 的取舍。答到:Zustand/Pinia 样板代码少、内置不可变更新;Redux 适合超大团队与时序回放,本路径不强制。
5.2 统一请求层
为什么需要它:每个页面各自写 fetch,token 拼接、错误提示、loading 状态到处重复。统一封装一次,全站复用。
核心机制:
- 基于 fetch 或 axios 建一个实例:baseURL、超时、请求拦截器加 token、响应拦截器拆包与错误。
- 错误模型:网络错误、HTTP 4xx/5xx、业务码错误三类分开处理。
- token 存哪:内存 + localStorage(注意 XSS 风险,敏感操作考虑 httpOnly Cookie,详见阶段 7)。
最小可运行示例:
// http.ts
const BASE = '/api'
export class ApiError extends Error {
constructor(public status: number, message: string, public code?: string) {
super(message)
}
}
async function request<T>(path: string, opts: RequestInit = {}): Promise<T> {
const token = useUserStore.getState().token
const res = await fetch(`${BASE}${path}`, {
...opts,
headers: {
'Content-Type': 'application/json',
...(token ? { Authorization: `Bearer ${token}` } : {}),
...opts.headers
}
})
if (res.status === 401) {
useUserStore.getState().logout()
location.href = '/login'
throw new ApiError(401, '未登录')
}
if (!res.ok) throw new ApiError(res.status, res.statusText)
return res.json() as Promise<T>
}
export const http = {
get: <T>(p: string) => request<T>(p),
post: <T>(p: string, body: unknown) => request<T>(p, { method: 'POST', body: JSON.stringify(body) })
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 401 死循环跳登录 | 登录接口也走拦截器跳登录 | 白名单排除 /api/auth/login |
| 错误被吞 | catch 后没抛 | 统一抛出由页面处理 |
面试考法:问 token 存 localStorage 还是 Cookie。答到:localStorage 方便但易受 XSS;httpOnly Cookie 防 XSS 但要处理 CSRF;按业务敏感度选。
5.3 服务端状态:TanStack Query
为什么需要它:自己管 loading/error/cache/重新拉取代码量巨大,TanStack Query(原 React Query)把这些标准化。
核心机制:
useQuery({ queryKey, queryFn }):queryKey 是缓存键,相同键复用缓存;queryFn真正发请求。useMutation:写操作(POST/PUT/DELETE),成功后invalidateQueries让相关列表失效重拉。- 缓存策略:
staleTime(多久内不重拉)、cacheTime(缓存保留时长)、refetchOnWindowFocus。
最小可运行示例:
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
interface User { id: number; name: string }
function useUser(id: number) {
return useQuery({
queryKey: ['user', id],
queryFn: () => http.get<User>(`/users/${id}`)
})
}
function useSaveUser() {
const qc = useQueryClient()
return useMutation({
mutationFn: (data: Partial<User>) => http.post('/users', data),
onSuccess: () => qc.invalidateQueries({ queryKey: ['users'] })
})
}
// 组件里
function Profile({ id }: { id: number }) {
const { data, isLoading, error } = useUser(id)
if (isLoading) return <p>加载中…</p>
if (error) return <p>出错了</p>
return <p>{data!.name}</p>
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 切回来重复拉 | staleTime 默认 0 | 设合理 staleTime |
| 改完列表不刷新 | 没 invalidate | onSuccess 里 invalidate 相关 key |
| queryKey 漏字段 | 缓存串数据 | key 包含所有影响结果的参数 |
面试考法:问为什么不用 Redux 存服务端数据。答到:Redux 是客户端状态,服务端数据有缓存、失效、后台更新、分页等需求,专用库更合适。
5.4 URL 状态同步
为什么需要它:列表页的筛选、分页、搜索应该能通过 URL 分享,刷新能还原。
核心机制:
- 用
?keyword=xx&page=2存状态;读 URL 初始化状态,状态变化写回 URL。 - React 用
useSearchParams(React Router);Vue 用route.query与router.replace。 - 不要把临时状态(如输入框未提交的值)写 URL。
最小可运行示例:
import { useSearchParams } from 'react-router-dom'
function UserList() {
const [params, setParams] = useSearchParams()
const page = Number(params.get('page') ?? 1)
const keyword = params.get('keyword') ?? ''
function onSearch(kw: string) {
setParams(p => { p.set('keyword', kw); p.set('page', '1'); return p })
}
// ...
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 前进后退不对 | 用了 replace 而不是 push | 搜索用 push、翻页用 replace 视需求 |
| 状态不同步 | 改 state 没写 URL | useEffect 里 setParams |
5.5 认证与 token 刷新
为什么需要它:token 过期时不能让用户重新登录,要静默刷新;401 时统一处理。
核心机制:
- 双 token:access token 短(15 分钟)、refresh token 长(7 天);access 过期用 refresh 换新的。
- 并发 401 时只发一次刷新请求,其它请求等结果后重试,避免刷新风暴。
- 刷新失败(refresh 也过期)才清登录态跳登录页。
最小可运行示例:
let refreshing: Promise<string> | null = null
async function refreshToken(): Promise<string> {
if (!refreshing) {
refreshing = http.post<{ token: string }>('/auth/refresh', {})
.then(r => { useUserStore.getState().setToken(r.token); return r.token })
.finally(() => { refreshing = null })
}
return refreshing
}
// 在 request 的 401 分支里(非刷新接口):
// const newToken = await refreshToken()
// 带上 newToken 重发原请求
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 并发刷新多次 | 没去重 | 用单个 refreshing Promise |
| 死循环 | 刷新接口本身 401 | 白名单排除刷新接口 |
5.6 错误处理与全局提示
为什么需要它:每个请求都写 try/catch 弹 toast 太重复,统一拦截器弹一次。
核心机制:响应拦截器根据错误码统一弹 message/notification;页面只处理业务特有的分支。
最小可运行示例:
// 伪代码:在 request 里
if (!res.ok) {
const err = await res.json().catch(() => ({}))
message.error(err.message ?? `请求失败 ${res.status}`)
throw new ApiError(res.status, err.message)
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 一次操作弹多个错 | 每个请求都弹 | 统一在拦截器弹一次 |
| 校验错误也弹全局 | 业务错误被当网络错 | 区分 code,页面自行处理表单错误 |
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 用户 store | Zustand/Pinia 存 token 并持久化 | 刷新仍登录 | 1.5 小时 |
| 请求实例 | 封装 fetch 自动带 token | 请求头里有 Authorization | 2 小时 |
| TanStack Query 列表 | 拉用户列表并 loading | 切回来不重复打 | 2 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 加 401 跳登录 | 拦截器统一处理 | 过期自动跳 | 2 小时 |
| 列表筛选同步 URL | 关键字与分页进 query | 刷新还原 | 2 小时 |
| 写操作后失效列表 | mutation 成功 invalidate | 列表自动刷新 | 1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 设计静默刷新 | 并发 401 只刷一次 | 不打多次刷新接口 | 3 小时 |
| 划分 store | 用户、权限、主题、各业务数据分拆 | 各 store 职责清晰 | 2 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 改 store 不更新 | 没走 action 或 selector | 看订阅方式 | 用 action/selector |
| 重复打接口 | staleTime 0 或 key 不稳定 | 看 queryKey | 设 staleTime、稳定 key |
| 401 死循环 | 刷新接口也跳登录 | 看白名单 | 排除 /auth/refresh |
| 并发刷新多次 | 没去重 | 看网络面板 | 用单例 refreshing |
| 改完列表不刷新 | 没 invalidate | 看 onSuccess | invalidate 相关 key |
| URL 刷新状态丢 | 没从 query 初始化 | 看读 URL 逻辑 | 初始化 state |
| token 没带 | 拦截器顺序错 | 看请求头 | 先读 store 再发 |
八、出口条件
全部勾选后进入 阶段 5 构建工具链与工程化。
- [ ] 能用 Zustand/Pinia 建并持久化一个登录态 store
- [ ] 能封装统一请求实例,自动带 token、统一错误提示
- [ ] 能用 TanStack Query 拉列表并在写操作后失效
- [ ] 能说清服务端状态与客户端状态的边界,不把接口数据塞全局 store
- [ ] 能把筛选/分页同步到 URL query 并支持刷新还原
- [ ] 能设计并发 401 只刷新一次的静默登录
自测题:
- 为什么不把所有接口数据都放进全局 store?
- 要点:服务端状态有缓存、失效、后台更新需求,专用查询库更合适。
- token 存 localStorage 有什么风险?
- 要点:XSS 可读取;敏感场景用 httpOnly Cookie。
- TanStack Query 的 queryKey 起什么作用?
- 要点:作为缓存键,相同键共享数据,变化触发重拉。
- 并发 401 怎么避免刷新风暴?
- 要点:用单例 Promise 去重,其它请求等待。
- URL 同步状态有什么好处?
- 要点:可分享、可刷新还原、前进后退可用。
- zustand 的 selector 解决了什么问题?
- 要点:只订阅需要的字段,避免无关重渲染。