页面刷新后恢复复杂对象结构的关键在于自定义序列化器:Pinia默认JSON.stringify会丢失Date、Map、Set、RegExp及函数等类型,需通过pinia-plugin-persistedstate配置serialize/deserialize函数,用__type标记还原;更推荐源头控制,如用字符串存日期、避免state中放不可序列化值,并验证instanceof和size等真实类型与状态。

页面刷新后恢复复杂对象结构,关键不是“存进去”,而是“怎么存”和“怎么读回来”。Pinia 默认用 JSON.stringify 序列化,而它天然不支持 Date、Map、Set、RegExp、函数、循环引用等——这些值一存就丢,一读就变 null 或空对象。
明确哪些类型会丢失
以下结构在默认持久化下会出问题:
-
new Date()→ 变成字符串或null -
new Map([['a', 1]])→ 变成空对象{} -
new Set([1, 2])→ 变成空数组[]或{} -
/(abc)/g→ 变成空对象 - 含
this、computed、function的字段 → 直接被 JSON 忽略
用自定义序列化器还原关键类型
以 pinia-plugin-persistedstate 为例,在 store 的 persist 配置中加入 serializer:
例如处理 Date 和 Map:
persist: {
enabled: true,
serializer: {
serialize: (state) => {
return JSON.stringify(state, (key, value) => {
if (value instanceof Date) return { __type: 'Date', value: value.toISOString() }
if (value instanceof Map) return { __type: 'Map', value: Array.from(value.entries()) }
if (value instanceof Set) return { __type: 'Set', value: Array.from(value.values()) }
return value
})
},
deserialize: (str) => {
return JSON.parse(str, (key, value) => {
if (value && value.__type === 'Date') return new Date(value.value)
if (value && value.__type === 'Map') return new Map(value.value)
if (value && value.__type === 'Set') return new Set(value.value)
return value
})
}
}
}
避免在 state 中直接放不可序列化值
更推荐的做法是:从源头控制结构。比如:
- 用字符串代替
Date(如createdAt: '2026-09-24T08:30:00Z'),需要时再转成Date实例 - 用普通对象或数组代替
Map/Set,除非业务强依赖其 API - 把函数、
computed、ref等响应式辅助项移出state,放在actions或getters中
验证是否真正恢复成功
别只看数据“还在不在”,要确认类型没变:
- 打开浏览器开发者工具 → Application → LocalStorage,找到对应 key,点开看原始字符串是否含
"__type":"Date"等标记 - 在组件中打印
store.$state.myDate instanceof Date,应为true - 对
Map字段,检查store.$state.myMap.size是否等于预期值,而不是undefined


















