Vuex页面刷新数据不丢失的几种解决方案

 更新时间:2025年07月23日 09:12:27   作者:江城开朗的豌豆  
相信很多用Vuex做状态管理的同学都遇到过这个问题——明明登录成功了,一刷新页面又跳回登录页;购物车里的商品,刷新后全空了,今天我就来分享几种解决方案,帮你彻底搞定这个烦人的问题

大家好。今天想和大家聊聊一个Vue项目中经常遇到的坑:用Vuex存储的数据,一刷新页面就没了!

相信很多用Vuex做状态管理的同学都遇到过这个问题——明明登录成功了,一刷新页面又跳回登录页;购物车里的商品,刷新后全空了。今天我就来分享几种解决方案,帮你彻底搞定这个烦人的问题。

一、为什么Vuex数据会丢失?

先搞清楚原理:Vuex的数据是存在内存中的。这就意味着:

  • 页面刷新 → 浏览器重新加载 → JavaScript内存重置 → Vuex数据清空

所以要想持久化数据,我们必须把数据存到“不会轻易丢失”的地方。常见的有三种方案:

二、解决方案1:localStorage/sessionStorage(简单粗暴)

这是最直接的方案,在Vuex数据变化时同步到Storage:

// store/index.js
const store = new Vuex.Store({
  state: {
    userInfo: JSON.parse(localStorage.getItem('userInfo')) || null
  },
  mutations: {
    setUserInfo(state, payload) {
      state.userInfo = payload
      localStorage.setItem('userInfo', JSON.stringify(payload)) // 同步存储
    },
    clearUserInfo(state) {
      state.userInfo = null
      localStorage.removeItem('userInfo') // 清除存储
    }
  }
})

// 使用示例
methods: {
  login() {
    const myData = { name: '小杨', token: 'abc123' }
    this.$store.commit('setUserInfo', myData)
  }
}

优点

  • 实现简单,无需额外库
  • 数据真·持久化(除非用户手动清除)

缺点

  • 需要手动同步,容易遗漏
  • 存储大小有限(通常5MB)

三、解决方案2:vuex-persistedstate(优雅推荐)

如果你不想自己写存储逻辑,可以用这个现成插件:

npm install vuex-persistedstate
// store/index.js
import createPersistedState from 'vuex-persistedstate'

const store = new Vuex.Store({
  // ...
  plugins: [
    createPersistedState({
      key: 'my-vuex-storage', // 存储的key名
      paths: ['userInfo', 'cart'], // 只持久化指定模块
      storage: window.sessionStorage // 改用sessionStorage
    })
  ]
})

插件原理

  1. 在Vuex初始化时从storage读取数据
  2. 订阅mutation,数据变化时自动更新storage

进阶配置

createPersistedState({
  storage: {
    getItem: key => uni.getStorageSync(key), // 小程序兼容方案
    setItem: (key, value) => uni.setStorageSync(key, value),
    removeItem: key => uni.removeStorageSync(key)
  }
})

四、解决方案3:Cookie(适合配合SSR)

如果需要和后端交互(比如自动带token),可以用Cookie存储:

import Cookies from 'js-cookie'

const store = new Vuex.Store({
  state: {
    token: Cookies.get('token') || null
  },
  mutations: {
    setToken(state, token) {
      state.token = token
      Cookies.set('token', token, { expires: 7 }) // 7天后过期
    }
  }
})

Cookie vs localStorage

特性CookielocalStorage
容量4KB左右5MB左右
是否随请求发送是(需注意安全)
服务端是否可读

五、性能与安全注意事项

不要什么数据都存:只存必要数据(如用户token、基础信息)

敏感信息处理

// 错误示范!存了密码明文
localStorage.setItem('password', '123456') 

// 正确做法:只存token
localStorage.setItem('token', '加密后的字符串')

定期清理:设置合理的过期时间

大对象慎存:可能影响页面加载性能

六、终极方案:组合拳

在我的实际项目中,通常会这样搭配使用:

  • 用户token → Cookie存储(方便SSR和HTTP自动携带)
  • 用户基础信息 → localStorage + Vuex(减少接口请求)
  • 临时数据 → 纯Vuex(如表单填写状态)

七、总结

方案适用场景一句话评价
localStorage需要长期存储的简单数据简单但需手动同步
vuex-persistedstate需要自动同步的复杂状态优雅但需引入额外依赖
Cookie需要服务端读取或SSR项目注意安全性和容量限制

最后提醒大家:前端存储永远不可信!  所有关键权限校验必须走后端接口。

写在最后​

到此这篇关于Vuex页面刷新不丢失的几种解决方案的文章就介绍到这了,更多相关Vuex页面刷新不丢失内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Vue指令修饰符,v-bind对样式控制的增强,computed计算属性,watch监视器详解

    Vue指令修饰符,v-bind对样式控制的增强,computed计算属性,watch监视器详解

    这篇文章主要介绍了Vue指令修饰符,v-bind对样式控制的增强,computed计算属性,watch监视器,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-06-06
  • vue父组件传值子组件报错Avoid mutating a prop directly解决

    vue父组件传值子组件报错Avoid mutating a prop directly解决

    这篇文章主要为大家介绍了vue父组件传值子组件报错Avoid mutating a prop directly解决,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-09-09
  • Vue2.0/3.0双向数据绑定的实现原理详解

    Vue2.0/3.0双向数据绑定的实现原理详解

    这篇文章主要给大家介绍了关于Vue2.0/3.0双向数据绑定的实现原理,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • vue3中的hook简单封装

    vue3中的hook简单封装

    这篇文章主要介绍了vue3中的hook简单封装,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-04-04
  • vue3点击按钮下载文件功能的代码实现

    vue3点击按钮下载文件功能的代码实现

    在写vue项目时,有个需求是点击表格中某一行的下载按钮,然后开始下载这一行对应的文件,所以本文小编给大家介绍了使用vue3实现点击按钮下载文件功能,文中有详细的代码示例供大家参考,需要的朋友可以参考下
    2024-01-01
  • vue openlayers实现台风轨迹示例详解

    vue openlayers实现台风轨迹示例详解

    这篇文章主要为大家介绍了vue openlayers实现台风轨迹示例详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-11-11
  • 关于vue.js中实现方法内某些代码延时执行

    关于vue.js中实现方法内某些代码延时执行

    今天小编就为大家分享一篇关于vue.js中实现方法内某些代码延时执行,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-11-11
  • vue制作toast组件npm包示例代码

    vue制作toast组件npm包示例代码

    这篇文章主要介绍了vue制作一个toast组件npm包,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-10-10
  • vue3+elementPlus项目支持设置默认附件方式

    vue3+elementPlus项目支持设置默认附件方式

    这篇文章主要介绍了vue3+elementPlus项目支持设置默认附件方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-03-03
  • vue中如何使用ztree

    vue中如何使用ztree

    这篇文章主要介绍了vue中如何使用ztree,包括配置package.json,自动加载jquery的方法,本文给大家介绍的非常详细,具有参考借鉴价值,需要的朋友可以参考下
    2018-02-02

最新评论