Vue Router 怎么使用全局前置守卫拦截未登录访问

云墨吖_6423

云墨吖_6423

2026-10-06

232人浏览

原创

router.beforeeach是实现登录拦截最直接可靠的位置,它在每次路由跳转前自动执行,通过白名单放行、登录态双校验、meta.requiresauth权限标记三步完成分层拦截,并支持重定向回原路径。

vue router 怎么使用全局前置守卫拦截未登录访问

用 router.beforeEach 就能实现——它在每次跳转前自动执行,是做登录拦截最直接、最可靠的位置。

核心判断逻辑:三步走

实际拦截不是“一刀切”,而是分层校验:

  • 先看是不是免登录页:比如 /login、/register、/404 这类路由,直接放行,不检查登录态
  • 再查有没有有效凭证:通常读取 localStorage 或 Cookie 中的 token,或结合 Vuex/Pinia 状态。注意别只依赖一个来源,建议双校验(如 token + isAuthenticated 标识)
  • 最后看目标页是否需要权限:通过路由配置里的 meta.requiresAuth: true 标记受保护页面,避免所有页面都走校验

关键代码写法(Vue 3 + Vue Router 4)

在 src/router/index.js 或 .ts 中配置:

vue-component-analyzer
vue-component-analyzer

递归分析 Vue 项目组件依赖,从入口文件生成组件层级图,支持 Vue 2/3,输出组件名、文件路径和属性。适用于分析组件结构、排查依赖或了解项目架构。

下载
router.beforeEach((to, from, next) => {
  // 1. 白名单放行
  const publicPages = ['/login', '/register', '/forgot-password'];
  if (publicPages.includes(to.path)) {
    next();
    return;
  }

  // 2. 检查登录态(示例:token 存在即视为已登录)
  const token = localStorage.getItem('token');
  if (token) {
    next(); // 已登录,放行
  } else {
    // 未登录,重定向到登录页,并带上原目标路径
    next({ path: '/login', query: { redirect: to.fullPath } });
  }
});

登录页怎么接住跳转?

用户被重定向到 /login?redirect=/admin/user 后,登录成功时要主动跳回去:

  • 在登录组件中读取 this.$route.query.redirect(Vue 2)或 useRoute().query.redirect(Vue 3 Composition API)
  • 登录成功后调用 router.push(redirect || '/')
  • 注意对 redirect 做基础校验(比如是否为合法路径),防跳转劫持

容易忽略但重要的细节

几个实战中常踩的坑:

  • next 必须且只能调用一次:漏调会卡死导航;重复调用可能引发警告甚至异常
  • 异步校验要等结果再 next:如果 token 需要解码或调接口验权,得用 await 或 Promise.then,不能直接 next()
  • 第三方登录场景要优先处理:比如 URL 带 ?token=xxx,应跳过常规登录检查,避免拦截回调流程
  • 路由元信息要统一约定:推荐用 meta: { auth: 'user' } 而非布尔值,方便后续扩展角色权限

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2303

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

4943

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6030

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5538

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

783

5

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1634

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

11882

5

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

2026.02.10

296

23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 16.9万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习