vue3动态路由解决刷新页面空白或跳转404问题

 更新时间:2025年01月22日 08:31:28   作者:micefind  
这篇文章主要为大家详细介绍了vue3如何通过动态路由解决刷新页面空白或跳转404问题,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下

前言

开发后台管理系统时,有时后端会根据权限返回不同的菜单列表,前端需要异步获取数据然后实时生成路由配置。

在vue3项目中,我们使用pinia、vue-router实现动态路由,关键步骤如下:

  • 异步请求获取路由接口数据;
  • pinia状态管理保存路由信息;
  • vue-router实现路由配置;
  • 动态添加路由。

1 异步请求获取路由接口数据

// /src/api/route.js
export const getRouteList = () => {
  // 模拟异步请求
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve([
        {
          name: "home",
          path: "/home",
          meta: { title: "首页" },
        },
        {
          name: "user",
          path: "/user",
          meta: { title: "用户" },
        },
      ])
    }, 1000)
  })
}

2 pinia状态管理保存路由信息

// /src/store/route.js
import { defineStore } from "pinia"

export const useRouteStore = defineStore("route", {
  state: () => ({
    routeList: sessionStorage.getItem("routeList")
      ? JSON.parse(sessionStorage.getItem("routeList"))
      : [],
    isUpdate: false,
  }),
  actions: {
    updateRouteList(routeList) {
      this.routeList = routeList
      sessionStorage.setItem("routeList", JSON.stringify(routeList))
      this.isUpdate = true
    },
  },
  getters: {},
})

3 vue-router实现路由配置

import { createRouter, createWebHashHistory } from "vue-router"

// 定义基本路由配置
const routes = [
  {
    path: "/:pathMatch(.*)",
    meta: { title: "404" },
    name: "404",
    component: () => import("@/views/error/404.vue"),
  },
  {
    path: "/login",
    name: "login",
    component: () => import("@/views/login/Login.vue"),
    meta: { title: "登录" },
  },
  {
    path: "/",
    name: "layout",
    component: () => import("@/views/layout/Layout.vue"),
    redirect: "/home",
    children: [], // 初始时没有子路由
  },
]

export const router = createRouter({
  history: createWebHashHistory(import.meta.env.BASE_URL),
  routes,
})

// 路由守卫,用于处理路由跳转前的逻辑
router.beforeEach(async (to, from, next) => {
  // 判断是否已登录且没有 token,未登录时重定向到登录页
  const token = localStorage.getItem("token")
  if (to.path !== "/login" && !token) {
    return next({ name: "login" })
  }
  next()
})

4 动态添加路由

核心代码

router.addRoute("layout", {
	path: item.path,
	name: item.name,
	component: () => import(`@/views/${item.name}/index.vue`),
})

完整代码

// /src/router/index.js
import { createRouter, createWebHashHistory } from "vue-router"
import { useRouteStore } from "@/store/route"
import { getRouteList } from "@/api/route"

// 定义基本路由配置
const routes = [
  {
    path: "/:pathMatch(.*)",
    meta: { title: "404" },
    name: "404",
    component: () => import("@/views/error/404.vue"),
  },
  {
    path: "/login",
    name: "login",
    component: () => import("@/views/login/Login.vue"),
    meta: { title: "登录" },
  },
  {
    path: "/",
    name: "layout",
    component: () => import("@/views/layout/Layout.vue"),
    redirect: "/home",
    children: [], // 初始时没有子路由
  },
]

export const router = createRouter({
  history: createWebHashHistory(import.meta.env.BASE_URL),
  routes,
})

// 添加动态路由
const addRoute = () => {
  const routeStore = useRouteStore()
  if (routeStore.isUpdate) {
    routeStore.routeList.forEach((item) => {
      if (!router.hasRoute(item.name)) {
        router.addRoute("layout", {
          path: item.path,
          name: item.name,
          component: () => import(`@/views/${item.name}/index.vue`),
        })
      }
    })
    routeStore.isUpdate = false
  }
}

// 初始化路由
export const initRouter = async () => {
  let routeList = sessionStorage.getItem("routeList")
    ? JSON.parse(sessionStorage.getItem("routeList"))
    : await getRouteList()
  const routeStore = useRouteStore()
  routeStore.updateRouteList(routeList)
  addRoute()
}

// 路由守卫,用于处理路由跳转前的逻辑
router.beforeEach(async (to, from, next) => {
  // 添加动态路由
  addRoute()
  // 判断是否已登录且没有 token,未登录时重定向到登录页
  const token = localStorage.getItem("token")
  if (to.path !== "/login" && !token) {
    return next({ name: "login" })
  }
  next()
})

注意:动态添加路由后刷新页面会跳转404页面,因为在进路由守卫之前,程序已经进行了路由匹配,结果就是没匹配到任何内容。

解决方案:在router注册之前调用initRouter函数初始化路由。

// main.js
import "./assets/css/main.css"

import { createApp } from "vue"
import { createPinia } from "pinia"
import App from "./App.vue"
import { initRouter, router } from "./router"

const app = createApp(App)

const call = async () => {
  app.use(createPinia())
  await initRouter()
  app.use(router)

  app.mount("#app")
}
call()

到此这篇关于vue3动态路由解决刷新页面空白或跳转404问题的文章就介绍到这了,更多相关vue3刷新页面空白或404内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Vue中的组件详谈

    Vue中的组件详谈

    这篇文章主要介绍了Vue的组件,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-10-10
  • 解决vuex数据页面刷新后初始化操作

    解决vuex数据页面刷新后初始化操作

    这篇文章主要介绍了解决vuex数据页面刷新后初始化操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-07-07
  • Vue进行数据可视化图表展示的实现示例

    Vue进行数据可视化图表展示的实现示例

    数据可视化是现代化的数据分析和展示方式,可以使数据更加直观、易于理解和传达,Vue作为一款流行的前端框架,提供了丰富的插件和工具来实现数据可视化图表展示,本文将介绍如何使用Vue和Echarts/D3.js来实现数据可视化图表展示,并提供示例代码和实际应用场景
    2023-10-10
  • Vue.js实现简单动态数据处理

    Vue.js实现简单动态数据处理

    本篇文章主要介绍了Vue.js实现简单动态数据处理,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-02-02
  • Vue+scss白天和夜间模式切换功能的实现方法

    Vue+scss白天和夜间模式切换功能的实现方法

    这篇文章主要介绍了Vue+scss白天和夜间模式切换功能的实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • vue $refs动态拼接获取值问题

    vue $refs动态拼接获取值问题

    这篇文章主要介绍了vue $refs动态拼接获取值问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-01-01
  • 解决vue初始化项目一直停在downloading template的问题

    解决vue初始化项目一直停在downloading template的问题

    这篇文章主要介绍了解决vue初始化项目一直停在downloading template的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-11-11
  • 在vue中给列表中的奇数行添加class的实现方法

    在vue中给列表中的奇数行添加class的实现方法

    今天小编就为大家分享一篇在vue中给列表中的奇数行添加class的实现方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-09-09
  • vue中实现点击变成全屏的多种方法

    vue中实现点击变成全屏的多种方法

    这篇文章主要介绍了vue中实现点击变成全屏的多种方法,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-09-09
  • vue2中使用sass并配置全局的sass样式变量的方法

    vue2中使用sass并配置全局的sass样式变量的方法

    这篇文章主要介绍了vue2中使用sass并配置全局的sass样式变量的方法,本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-09-09

最新评论