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-router的两种模式的区别

    vue-router的两种模式的区别

    这篇文章主要介绍了vue-router的两种模式的区别,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-05-05
  • vue3 表单搜索内容回显到地址栏的实例代码

    vue3 表单搜索内容回显到地址栏的实例代码

    这篇文章主要介绍了vue3 表单搜索内容回显到地址栏的实例代码,地址栏输入内容回显到form表单,同理表单输入内容也要回显到地址栏中,本文结合实例代码介绍的非常详细,需要的朋友可以参考下
    2023-09-09
  • 在Vue中使用xlsx组件实现Excel导出功能的步骤详解

    在Vue中使用xlsx组件实现Excel导出功能的步骤详解

    在现代Web应用程序中,数据导出到Excel格式是一项常见的需求,Vue.js是一种流行的JavaScript框架,允许我们构建动态的前端应用程序,本文将介绍如何使用Vue.js和xlsx组件轻松实现Excel数据导出功能,需要的朋友可以参考下
    2023-10-10
  • Vue 3.0 v-for中的Ref数组用法小结

    Vue 3.0 v-for中的Ref数组用法小结

    在 Vue 2 中,在 v-for 里使用的 ref attribute会用ref 数组填充相应的 $refs property,本文给大家介绍Vue 3.0 v-for中的Ref数组的相关知识,感兴趣的朋友一起看看吧
    2023-12-12
  • vue实现虚拟滚动渲染成千上万条数据

    vue实现虚拟滚动渲染成千上万条数据

    本文主要介绍了vue实现虚拟滚动渲染成千上万条数据,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-02-02
  • 基于el-table实现行内增删改功能

    基于el-table实现行内增删改功能

    这篇文章主要介绍了基于el-table实现行内增删改功能,用过通过操作按钮点击删除或者编辑功能即可实现相应的效果,下面小编给大家分享实例代码感兴趣的朋友跟随小编一起看看吧
    2024-04-04
  • Vue监听数组变化源码解析

    Vue监听数组变化源码解析

    这篇文章主要为大家详细解析了Vue监听数组变化的源码,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-03-03
  • 如何使用JS监听一个变量改变

    如何使用JS监听一个变量改变

    在JS编程中如果能监测变量的内容,当变量值发生变化时,实时发出通知,这定是一项很有用的功能,下面这篇文章主要给大家介绍了关于如何使用JS监听一个变量改变的相关资料,需要的朋友可以参考下
    2023-05-05
  • vue父子组件传值不能实时更新的解决方法

    vue父子组件传值不能实时更新的解决方法

    Vue是一个以数据驱动、组件化的前端框架,其中组件化是Vue中较为重要的概念之一,组件之间的通信则成为Vue中较为普遍的需求,下面这篇文章主要给大家介绍了关于vue父子组件传值不能实时更新的解决方法,需要的朋友可以参考下
    2023-05-05
  • 利用vue实现密码输入框/验证码输入框

    利用vue实现密码输入框/验证码输入框

    这篇文章主要为大家详细介绍了如何利用vue实现密码输入框或验证码输入框的效果,文中的示例代码讲解详细,感兴趣的小伙伴可以参考一下
    2023-08-08

最新评论