Vue / 系统课时

状态持久化策略

状态持久化策略

状态持久化不是“把整个 Pinia 写进 localStorage”,而是按数据敏感度、恢复价值和生命周期选择落点。本节会建立可执行的分层策略,并实现只保存偏好与业务草稿、登录态由服务端会话恢复的方案。

学习目标

  • 区分登录态、偏好设置与业务草稿各自适合的持久化位置
  • 用类型安全的 Pinia Store 只保存允许恢复的字段
  • 处理版本升级、损坏数据、退出登录和跨账号恢复边界

先决定哪些状态值得保存

持久化的第一条规则是“最小化”。主题、语言、列表密度等偏好适合保存在浏览器;可恢复草稿可以本地保存,并带版本号与更新时间;真正的身份凭据则应优先依赖服务端会话和 HttpOnly Cookie,而不是复制进可被脚本读取的存储。

状态 推荐落点 关键原因
登录身份 服务端会话 + HttpOnly Cookie 避免前端脚本长期持有敏感凭据
主题、语言 localStorage 体积小、跨页面稳定恢复
可恢复草稿 localStorage 或 IndexedDB 允许刷新后继续编辑,可单独清理
临时筛选、弹窗状态 仅 Pinia 内存 恢复价值低,持久化反而制造脏状态

登录态、偏好和草稿的持久化分层

实现按字段持久化

下面的 Store 不持久化 profile,只保存主题、语言和草稿。草稿加入 version,以后字段结构变化时可以显式迁移,而不是让旧数据直接污染新版本。

ts
import { defineStore } from 'pinia'

type Theme = 'light' | 'dark'

interface DraftSnapshot {
  version: 1
  content: string
  updatedAt: number
}

interface PersistedState {
  theme: Theme
  locale: string
  draft: DraftSnapshot | null
}

interface AppState extends PersistedState {
  profile: { userId: string; displayName: string } | null
}

const STORAGE_KEY = 'enterprise.app.state.v1'

function loadPersistedState(): PersistedState {
  const fallback: PersistedState = {
    theme: 'light',
    locale: 'zh-CN',
    draft: null,
  }

  const raw = localStorage.getItem(STORAGE_KEY)
  if (!raw) return fallback

  try {
    const parsed = JSON.parse(raw) as Partial<PersistedState>
    return {
      theme: parsed.theme === 'dark' ? 'dark' : 'light',
      locale: typeof parsed.locale === 'string' ? parsed.locale : 'zh-CN',
      draft: parsed.draft?.version === 1 ? parsed.draft : null,
    }
  } catch {
    localStorage.removeItem(STORAGE_KEY)
    return fallback
  }
}

function createState(): AppState {
  return {
    ...loadPersistedState(),
    profile: null,
  }
}

export const useAppStore = defineStore('app', {
  state: createState,
  actions: {
    persistAllowedFields() {
      const payload: PersistedState = {
        theme: this.theme,
        locale: this.locale,
        draft: this.draft,
      }
      localStorage.setItem(STORAGE_KEY, JSON.stringify(payload))
    },
    setPreference(theme: Theme, locale: string) {
      this.theme = theme
      this.locale = locale
      this.persistAllowedFields()
    },
    saveDraft(content: string) {
      this.draft = { version: 1, content, updatedAt: Date.now() }
      this.persistAllowedFields()
    },
    clearPersistedState() {
      localStorage.removeItem(STORAGE_KEY)
      this.$reset()
    },
  },
})

这是项目内的完整 Store 文件,依赖应用已经安装 Pinia,并运行在浏览器环境。若项目采用 SSR,应把 localStorage 访问放到客户端生命周期或封装存储适配器中,避免服务端执行时报错。

验证恢复与清理行为

下面是片段示例,依赖应用已经通过 app.use(pinia) 激活 Pinia,并能导入 useAppStore。在调试代码或组件事件中执行这些调用,可以确认只落盘允许字段,并验证清理动作。

ts
const store = useAppStore()

store.setPreference('dark', 'en-US')
store.saveDraft('报价单草稿')
console.log(localStorage.getItem('enterprise.app.state.v1'))

store.clearPersistedState()
console.log(localStorage.getItem('enterprise.app.state.v1'))

预期输出

text
{"theme":"dark","locale":"en-US","draft":{"version":1,"content":"报价单草稿","updatedAt":<TIME>}}
null

<TIME> 是运行时生成的毫秒时间戳,实际值会不同。刷新页面后,主题、语言和草稿会从存储恢复,而 profile 仍为空,应通过当前服务端会话重新请求用户信息。

处理账号切换和结构升级

本地草稿必须绑定业务上下文。若同一浏览器可能登录不同账号,存储键至少应包含用户或租户维度,或者在退出登录时清理用户相关草稿,避免 A 用户看到 B 用户留下的数据。

数据结构升级时不要假设旧 JSON 永远兼容。读取阶段先校验版本,再决定迁移、忽略或清理;对于金额、审批单、未提交表单等高价值草稿,还应考虑服务端草稿接口或 IndexedDB,而不是把 localStorage 当成可靠数据库。

持久化的目标不是“刷新后什么都不丢”,而是让真正值得恢复的数据可控地回来,同时让身份、临时状态和过期结构在正确的边界被重新建立。

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

目录与阅读设置

阅读设置

17

记录一个想法

状态持久化策略

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

登录哪都通