Vue3中导航守卫结合Axios实现token认证机制

 更新时间:2025年01月24日 08:29:49   作者:匹马夕阳  
本文主要介绍了Vue3中导航守卫结合Axios实现token认证机制,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

在Vue 3中,导航守卫(Navigation Guard)用于拦截路由的变化,可以在用户访问页面前进行检查。结合Axios进行token认证机制时,我们可以通过导航守卫在路由跳转时,检查用户的认证状态,确保用户有有效的token进行认证。

1. 安装必要的依赖

首先,确保你已经安装了 axios,这是我们用来发起 HTTP 请求的库。

npm install axios

2. 创建 axios 实例

我们通常会创建一个封装了token认证逻辑的 axios 实例,便于管理所有请求。

// src/utils/axios.js
import axios from 'axios';

const instance = axios.create({
  baseURL: 'https://api.example.com', // 设置基本的 API 地址
  timeout: 5000, // 设置请求超时
});

// 请求拦截器
instance.interceptors.request.use(config => {
  const token = localStorage.getItem('token'); // 从localStorage获取token
  if (token) {
    config.headers['Authorization'] = `Bearer ${token}`; // 在请求头中加入token
  }
  return config;
}, error => {
  return Promise.reject(error);
});

// 响应拦截器
instance.interceptors.response.use(response => {
  return response;
}, error => {
  if (error.response.status === 401) {
    // 如果响应返回 401,表示未授权,可以跳转到登录页面
    window.location.href = '/login';
  }
  return Promise.reject(error);
});

export default instance;

3. 在 router.js 中使用导航守卫

接下来,在 router.js 中配置路由的导航守卫,检查每次路由跳转前的用户认证状态。

// src/router/index.js
import { createRouter, createWebHistory } from 'vue-router';
import axios from '../utils/axios'; // 导入axios实例
import Home from '../views/Home.vue';
import Login from '../views/Login.vue';

const routes = [
  {
    path: '/',
    name: 'Home',
    component: Home,
    meta: { requiresAuth: true }, // 需要认证的页面
  },
  {
    path: '/login',
    name: 'Login',
    component: Login,
  },
];

const router = createRouter({
  history: createWebHistory(process.env.BASE_URL),
  routes,
});

// 全局前置守卫
router.beforeEach(async (to, from, next) => {
  const token = localStorage.getItem('token');
  
  if (to.meta.requiresAuth) {
    if (!token) {
      // 如果目标路由需要认证且没有token,跳转到登录页
      return next({ name: 'Login' });
    }
    
    try {
      // 如果有token,验证token是否有效
      const response = await axios.get('/verify-token'); // 假设后端提供了验证token的接口
      if (response.status === 200) {
        next(); // token有效,允许继续访问
      }
    } catch (error) {
      // token无效或请求失败,跳转到登录页
      localStorage.removeItem('token'); // 清除无效token
      next({ name: 'Login' });
    }
  } else {
    next(); // 不需要认证的页面,直接访问
  }
});

export default router;

4. 处理登录与登出逻辑

在用户登录时,我们会获取token并将其存储在 localStorage 中;登出时,我们需要清除token。

// src/views/Login.vue
<template>
  <div>
    <h1>Login</h1>
    <form @submit.prevent="handleLogin">
      <input v-model="username" placeholder="Username" />
      <input v-model="password" type="password" placeholder="Password" />
      <button type="submit">Login</button>
    </form>
  </div>
</template>

<script>
import axios from '../utils/axios';

export default {
  data() {
    return {
      username: '',
      password: '',
    };
  },
  methods: {
    async handleLogin() {
      try {
        const response = await axios.post('/login', {
          username: this.username,
          password: this.password,
        });
        const token = response.data.token;
        localStorage.setItem('token', token); // 保存token
        this.$router.push('/'); // 登录成功后跳转到首页
      } catch (error) {
        console.error('Login failed:', error);
      }
    },
  },
};
</script>
// src/views/Home.vue
<template>
  <div>
    <h1>Welcome Home</h1>
    <button @click="handleLogout">Logout</button>
  </div>
</template>

<script>
export default {
  methods: {
    handleLogout() {
      localStorage.removeItem('token'); // 清除token
      this.$router.push('/login'); // 跳转到登录页
    },
  },
};
</script>

5. 使用场景

这个 token 认证机制可以应用于任何需要用户登录的页面。例如,用户在访问需要身份认证的页面(如首页)时,首先会触发导航守卫,在守卫中验证 token 是否有效。如果没有有效的 token,用户会被重定向到登录页面。

场景总结:

  • 首页 (/): 需要 token 来验证用户身份。导航守卫检查 token 是否存在并有效。
  • 登录页 (/login): 用户输入用户名和密码后,向后端发送请求,获取并存储 token。
  • 全局登出: 用户登出时,清除 token 并跳转到登录页。

6. 总结

通过上述步骤,我们已经实现了:

  • 使用 axios 进行 token 的请求头设置与认证。
  • 在 Vue 3 的路由中使用导航守卫拦截认证逻辑。
  • 在登录时保存 token,并在用户访问需要认证的页面时检查 token 是否有效。

这种认证机制可以有效地保证用户在访问敏感页面时,必须通过认证,而不会直接跳过认证过程。

到此这篇关于Vue3中导航守卫结合Axios实现token认证机制的文章就介绍到这了,更多相关Vue3 token认证机制内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue实现登录验证码

    vue实现登录验证码

    这篇文章主要为大家详细介绍了vue实现登录验证码,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • 详解使用element-ui table组件的筛选功能的一个小坑

    详解使用element-ui table组件的筛选功能的一个小坑

    在element ui 框架中,对于table框架,有一个筛选功能,这篇文章主要介绍了详解使用element-ui table组件的筛选功能的一个小坑,非常具有实用价值,需要的朋友可以参考下
    2018-11-11
  • Vue.js如何监听window窗口尺寸变化

    Vue.js如何监听window窗口尺寸变化

    使用VUE开发后台项目,后台项目需要进行后台根据浏览器窗口进行变化,需要使用vue来监听浏览器的窗口变化,这篇文章主要给大家介绍了关于Vue.js如何监听window窗口尺寸变化的相关资料,需要的朋友可以参考下
    2023-11-11
  • Vue3中局部组件和全局组件的使用教程详解

    Vue3中局部组件和全局组件的使用教程详解

    这篇文章主要为大家学习介绍了Vue3中局部组件和全局组件的使用方法,文中的示例代码讲解详细,具有一定的借鉴价值,需要的小伙伴可以学习一下
    2023-07-07
  • Vue2(三)实现子菜单展开收缩,带动画效果实现方法

    Vue2(三)实现子菜单展开收缩,带动画效果实现方法

    这篇文章主要介绍了vue实现收缩展开效果的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-04-04
  • vue监听浏览器的后退和刷新事件,阻止默认的事件方式

    vue监听浏览器的后退和刷新事件,阻止默认的事件方式

    这篇文章主要介绍了vue监听浏览器的后退和刷新事件,阻止默认的事件方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-10-10
  • vue实现移动端省市区选择

    vue实现移动端省市区选择

    这篇文章主要为大家详细介绍了vue实现移动端省市区选择,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-09-09
  • vue使用element-ui按需引入时踩过的那些坑

    vue使用element-ui按需引入时踩过的那些坑

    Element-UI是基于vue实现的一套不依赖业务的UI组件库,提供了丰富的PC端组件,减少用户对常用组件的封装,降低了开发的难易程度,下面这篇文章主要给大家介绍了关于vue使用element-ui按需引入时踩过的那些坑,需要的朋友可以参考下
    2022-05-05
  • vue项目打包后打开页面空白解决办法

    vue项目打包后打开页面空白解决办法

    这篇文章主要介绍了vue项目打包后打开空白解决办法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-06-06
  • 使用 vite external 减小产物体积的方法实现

    使用 vite external 减小产物体积的方法实现

    本文主要介绍了使用 vite external 减小产物体积,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2026-05-05

最新评论