Pinia持久化插件中如何优化存储结构

问题背景

在使用pinia-plugin-persistedstate插件时，开发者经常会遇到存储结构不符合预期的情况。默认情况下，插件会将整个store的状态对象原样保存到存储中，这可能导致存储结构不够简洁或不符合项目需求。

默认存储行为分析

当使用组合式API定义Pinia store时，如果我们将状态封装在一个reactive对象中，例如：

const userState = reactive({
  userInfo: {
    username: "",
    nickname: "",
  },
  token: "",
})

默认情况下，持久化插件会将整个userState对象作为store的一个属性保存，导致存储结构如下：

{
  "userState": {
    "userInfo": {
      "username": "teacher_D"
    },
    "token": "2022-10-31T22:04:06.255+08:00"
  }
}

期望的存储结构

开发者通常希望存储结构更加扁平化，例如：

{
  "userInfo": {
    "username": "teacher_D"
  },
  "token": "2022-10-31T22:04:06.255+08:00"
}

解决方案

1. 使用serializer自定义序列化

最有效的解决方案是使用插件的serializer选项来自定义序列化和反序列化过程：

persist: {
  serializer: {
    serialize: state => JSON.stringify(state['userState']),
    deserialize: parseState => ({ userState: JSON.parse(parseState)})
  }
}

这种方法通过：

1. serialize函数：在保存时只提取userState部分进行序列化
2. deserialize函数：在读取时将解析后的数据重新包装为userState对象

2. 关于beforeRestore/afterRestore的说明

虽然插件提供了beforeRestore和afterRestore钩子，但它们主要用于触发副作用操作，并不适合用来修改存储结构。这些钩子的典型用途包括：

• 在恢复状态前显示加载指示器
• 在恢复状态后触发某些业务逻辑
• 记录状态恢复的相关日志

3. 其他可能的解决方案

对于更复杂的需求，可以考虑：

1. 自定义存储适配器：实现自己的存储逻辑，完全控制数据的保存和读取方式
2. 状态设计重构：重新设计store的结构，使其更符合持久化需求
3. 中间件处理：在数据保存前和读取后添加处理层

最佳实践建议

1. 保持存储结构简洁：避免不必要的嵌套层级
2. 考虑数据迁移：如果修改存储结构，要考虑已有用户数据的兼容性
3. 性能考量：对于大型应用，自定义序列化可能影响性能
4. 安全性：敏感信息应考虑加密存储

通过合理使用pinia-plugin-persistedstate插件的自定义序列化功能，开发者可以灵活控制持久化数据的存储结构，满足各种业务场景的需求。