讲师中心 微信公众号
AI工具推荐 视频效率加速

Vue Axios 网络请求怎么在请求拦截器中自动携带本地存储的 Token

秋静大大_9120

秋静大大_9120

发布时间:2026-08-07 14:11:05

|

612人浏览过

|

来源于php中文网

原创

在 Vue 项目中,最规范做法是通过 Axios 请求拦截器自动携带 localStorage 中的 Token。具体为:封装 axios 实例并配置 baseURL、超时等;请求前读取 token 并设为 Authorization 头,支持 skipAuth 跳过;处理 Content-Type、耗时埋点及多来源兼容;最后全局挂载供组件调用。

vue axios 网络请求怎么在请求拦截器中自动携带本地存储的 token

在 Vue 项目中,通过 Axios 请求拦截器自动携带本地存储的 Token 是最规范、可维护性最强的做法。核心逻辑是:每次发请求前,从 localStorage(或 sessionStorage)读取 token,并注入到请求头的 Authorization 字段中,且支持跳过认证的特殊请求。

创建统一的 axios 实例并配置基础参数

不要直接使用 axios 原生对象,而是新建一个封装实例,便于集中管理 baseURL、超时、跨域等配置:

  • 在 src/utils/request.js(或 src/service/index.js)中创建实例
  • 设置 baseURL 为后端 API 根路径,避免每个请求写完整 URL
  • 启用 withCredentials: true(如需携带 cookie)
  • 设置合理超时时间(例如 10000 毫秒)

在请求拦截器中读取并注入 Token

关键步骤是在请求发出前检查是否存在有效 token,并决定是否添加到请求头:

vue-component-analyzer
vue-component-analyzer

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

下载
  • 从 localStorage.getItem('token') 或 sessionStorage.getItem('token') 获取 token(推荐用 localStorage 保持登录态)
  • 判断 token 是否存在且非空字符串;若不存在,可选择跳过、清空状态或重定向登录页
  • 默认添加 config.headers.Authorization = 'Bearer ' + token
  • 支持灵活跳过:给请求配置加 skipAuth: true,比如登录接口本身就不需要 token

处理常见边界情况

实际项目中容易忽略但必须考虑的细节:

立即学习“前端免费学习笔记(深入)”;

  • Content-Type 自动推断:若未手动设置 Content-Type,可根据 config.data 类型(如 FormData、Plain Object、JSON 字符串)自动补全,避免后端解析失败
  • 请求耗时埋点:可在拦截器里记录 config.metadata = { startTime: new Date() },供响应拦截器计算耗时
  • 多 token 来源兼容:如果项目同时用 Pinia/Vuex 管理 token,优先读取 store 状态,fallback 到 localStorage
  • 空格与格式校验:确保 token 字符串不包含首尾空格,避免 Bearer  xxx 导致认证失败

导出并全局挂载使用

完成封装后,在 main.js 或 app.js 中统一挂载,让所有组件可通过 this.$http 或组合式 API 的 useRequest 调用:

  • 导出封装后的实例:export default service
  • 挂载到 Vue 原型:app.config.globalProperties.$http = service(Vue 3 setup 语法糖下推荐用 provide/inject 或独立 hooks)
  • 组件内直接调用:this.$http.get('/user') 或 await api.get('/profile'),无需重复传 token

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

2323

2023.08.11

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

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

5023

2023.10.09

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

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

6110

2024.03.19

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

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

5618

2024.03.22

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

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

803

2024.05.22

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

11399

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1026

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

764

2024.02.23

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

热门下载

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

精品课程

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

共42课时 | 17万人学习

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

共12课时 | 1.4万人学习

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

共18课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn