Vue使用Axios添加自定义请求头的多种方式

 更新时间:2025年05月16日 17:20:53   作者:大巨头  
Axios 是一个基于 promise 的 HTTP 库,可以用在浏览器和 node.js 中,这篇文章给大家介绍了Vue使用Axios添加自定义请求头的多种方式,并通过代码讲解的非常详细,需要的朋友可以参考下

在 Vue 中使用 Axios 添加自定义请求头有多种方式,以下是详细实现方案:

1. 全局设置(适用于所有请求)

// main.js 或 axios 配置文件中
import axios from 'axios';

axios.defaults.headers.common['X-Custom-Header'] = 'default-value';
axios.defaults.headers.post['Content-Type'] = 'application/json'; // 设置POST默认头

2. 实例配置(推荐方式)

// 创建axios实例(api.js)
const http = axios.create({
  baseURL: process.env.VUE_APP_API_BASE_URL,
  headers: {
    'X-Requested-With': 'XMLHttpRequest',
    'X-Custom-Header': 'instance-value'
  }
});

3. 请求拦截器设置(动态头)

http.interceptors.request.use(config => {
  // 动态设置认证头
  const token = localStorage.getItem('token');
  if (token) {
    config.headers.Authorization = `Bearer ${token}`;
  }
  
  // 固定业务头
  config.headers['X-Client-Version'] = '1.0.0';
  config.headers['X-Platform'] = 'Web';
  
  return config;
}, error => {
  return Promise.reject(error);
});

4. 单个请求设置

// GET请求
this.$http.get('/api/data', {
  headers: {
    'X-Special-Header': 'for-this-request-only'
  }
});

// POST请求
this.$http.post('/api/save', data, {
  headers: {
    'X-Data-Type': 'json',
    'X-Request-ID': uuidv4() // 生成唯一ID
  }
});

5. 处理常见问题

问题1:CORS 预检请求

// 确保服务器允许自定义头
// 示例:Nginx配置
add_header 'Access-Control-Allow-Headers' 'X-Custom-Header, Authorization';

问题2:头信息被覆盖

// 在拦截器中合并头信息
config.headers = {
  ...config.headers,
  'X-New-Header': 'value',
  'Content-Type': 'application/json' // 明确设置内容类型
};

问题3:开发环境代理配置

// vue.config.js
devServer: {
  proxy: {
    '/api': {
      target: 'http://backend:8080',
      headers: {
        'X-Proxy-Header': 'vue-dev-server'
      }
    }
  }
}

6. TypeScript 类型支持(如使用TS)

declare module 'axios' {
  interface AxiosRequestConfig {
    customMetadata?: {
      startTime?: number;
      retryCount?: number;
    };
  }
}

// 使用扩展配置
http.get('/api', {
  customMetadata: {
    startTime: Date.now()
  },
  headers: {
    'X-Performance-Marker': 'start'
  }
});

最佳实践建议:

  • 敏感头(如Authorization)建议只在拦截器中设置
  • 业务相关头(如X-User-Type)建议在实例级别设置
  • 临时特殊头(如X-Debug-Mode)在单个请求设置
  • 所有自定义头应以X-前缀开头(传统约定)
  • 生产环境应移除不必要的头信息

通过以上方法,你可以灵活地在Vue项目中管理各种自定义请求头,同时保持良好的代码组织和可维护性。

以上就是Vue使用Axios添加自定义请求头的多种方式的详细内容,更多关于Vue Axios添加自定义请求头的资料请关注脚本之家其它相关文章!

相关文章

  • 解决Vue3.0刷新页面警告[Vue Router warn]:No match found for location with path /xxx

    解决Vue3.0刷新页面警告[Vue Router warn]:No match 

    这篇文章主要介绍了解决Vue3.0刷新页面警告[Vue Router warn]:No match found for location with path /xxx问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-03-03
  • vue实现点击图片放大效果

    vue实现点击图片放大效果

    这篇文章主要为大家详细介绍了vue实现点击图片放大效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-08-08
  • vue基础之详解ElementUI的表单

    vue基础之详解ElementUI的表单

    这篇文章主要为大家详细介绍了vue基础之ElementUI的表单,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-02-02
  • Vue父子组件之间的通信实例详解

    Vue父子组件之间的通信实例详解

    在vue组件通信中其中最常见通信方式就是父子组件之中的通信,而父子组件的设定方式在不同情况下又各有不同。这篇文章主要介绍了Vue---父子组件之间的通信,需要的朋友可以参考下
    2018-09-09
  • Nuxt.js实现一个SSR的前端博客的示例代码

    Nuxt.js实现一个SSR的前端博客的示例代码

    这篇文章主要介绍了Nuxt.js实现一个SSR的前端博客的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-09-09
  • vue2如何使用simple-keyboard软键盘有中文(拼音)

    vue2如何使用simple-keyboard软键盘有中文(拼音)

    这篇文章主要介绍了vue2如何使用simple-keyboard软键盘有中文(拼音),具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-04-04
  • Vue表单快速上手

    Vue表单快速上手

    工作中vue表单使用的最多的莫过于input、textarea、select等,原生js的基础上vue通过双向数据绑定等,实现了自己独有的一套指令,这是react中没有的部分,也算是vue的一大特色
    2022-09-09
  • Vue自定义依赖引入的最佳实践记录

    Vue自定义依赖引入的最佳实践记录

    在现代前端开发中,自定义引入依赖是提升开发效率的关键,unplugin-auto-import插件可以帮助开发者自动引入JS模块,包括本地编写的工具方法和第三方库,通过简单的配置,开发者可以实现Vue基本库、本地文件以及第三方插件的自动引入
    2024-10-10
  • 详解vue+webpack+express中间件接口使用

    详解vue+webpack+express中间件接口使用

    这篇文章主要介绍了详解vue+webpack+express中间件接口使用,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-07-07
  • vue 设置路由的登录权限的方法

    vue 设置路由的登录权限的方法

    这篇文章主要介绍了vue 设置路由的登录权限的方法,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-07-07

最新评论