Web Storage存储状态下的数据迁移逻辑设计

Web Storage 数据迁移是人为设计的状态延续策略，非自动机制；需明确可迁数据（如主题、语言）、不可迁数据（如过期token）、舍弃数据（如sessionStorage）；通过版本标识、字段映射、渐进清理实现兼容；跨域依赖服务端中转或用户导出；须保障安全与原子性。

Web Storage 本身不涉及传统意义上的“数据迁移”，它没有跨设备、跨浏览器或服务端同步的内置机制。所谓“Web Storage 存储状态下的数据迁移逻辑”，实际是指在应用升级、用户换设备、浏览器重装或账号体系重构等场景中，如何安全、可控地将 localStorage 或 sessionStorage 中的客户端状态数据，迁移到新环境（如新域名、新版本前端、新登录态、甚至服务端）的过程。这本质是人为设计的数据延续策略，而非自动迁移。

明确迁移触发场景与边界

不是所有 Web Storage 数据都需要迁移，也并非都能迁移。需先界定：

1. 哪些数据可迁：用户主题偏好（theme）、语言设置（lang）、表单草稿（draft_content）、UI 展开状态（sidebar_collapsed）等非敏感、结构简单、同源可用的数据
2. 哪些数据不可迁或需转换：含时效性令牌（如过期时间未校验的 token）、绑定旧 session ID 的缓存、依赖旧版 API 响应结构的本地缓存数据
3. 哪些数据必须舍弃：sessionStorage 全部内容（会话级，关闭即失效）；localStorage 中硬编码的调试开关、临时测试配置、已废弃字段

设计迁移路径与兼容层

迁移不是简单复制 key-value，而是建立新旧版本间的语义映射和格式适配：

1. 版本标识前置：在 localStorage 中存一个 __storage_version 字段，记录当前数据结构版本（如 "v2.1"），迁移前先读取并比对目标版本
2. 字段映射与转换：例如旧版存 user_config: { theme: 'dark', lang: 'zh-CN' }，新版改为扁平键 theme: 'dark', language: 'zh'，需编写转换函数统一处理
3. 渐进式清理：迁移后保留旧字段一段时间（如 7 天），加标记 __migrated_v2_1，避免重复执行；旧字段在下次启动时按策略自动删除

处理跨域/跨设备迁移限制

Web Storage 受同源策略严格约束，无法直接跨域名、跨协议或跨浏览器读取。可行方案包括：

1. 服务端中转：用户登录后，前端将加密后的 localStorage 内容（剔除敏感项）通过 API 提交到服务端，关联用户 ID；新设备登录时拉取并还原
2. 用户主动导出导入：提供 JSON 导出按钮（JSON.stringify(localStorage)），支持用户手动导入；适合轻量级配置迁移
3. 基于 IndexedDB + 同步服务：对复杂状态（如离线编辑内容），改用 IndexedDB 存储，并搭配后台同步（Background Sync）或 Push API 实现跨设备状态推送

保障迁移过程中的数据安全与一致性

迁移操作一旦出错，可能导致用户丢失个性化体验甚至功能异常：

1. 禁止存储敏感数据：token、密码、身份证号等绝不进入 localStorage；若旧版已存，迁移前必须清洗或替换为服务端下发的短期凭证
2. 原子化写入与回滚标记：使用 try-catch 封装迁移逻辑；失败时清除已写入的新字段，并恢复旧字段值（如有备份）
3. 静默迁移 + 用户感知平衡：对用户无感的操作（如偏好设置迁移）直接执行；对可能影响功能的变更（如缓存格式升级），可在首次加载时弹窗提示“正在优化您的设置”