当前位置：首页 > news >正文

Axios 实例配置指南

news 2025/8/31 6:12:49

今天分享一段 Axios 实例配置的代码，用于 Web Front - End 项目的构建。

一、为什么使用 Axios

在前端项目中，与后端进行数据交互是必不可少的。Axios 是一个基于 Promise 的 HTTP 客户端，它提供了简洁的 API 和强大的功能，能够方便地发送 HTTP 请求。它支持浏览器和 Node.js，具有以下优点：

简洁易用：提供简洁的 API，易于上手和使用。
功能强大：支持请求和响应拦截器，可以方便地处理请求和响应数据。
跨浏览器兼容：在各种浏览器环境中都能稳定运行。
支持 Promise：基于 Promise 的设计，使得异步请求更加方便。

二、Axios 实例配置代码

1. 引入 Axios

首先，你需要安装 Axios。如果你使用的是 npm，可以通过以下命令安装：

npm install axios

然后，在你的项目中引入 Axios：

import axios from "axios";

2. 创建 Axios 实例

创建一个 Axios 实例，可以设置一些默认的配置，如基础 URL 和超时时间：

// 创建实例
const request = axios.create({baseURL: 'http://localhost:8000/', // 设置请求的基础路径timeout: 3000000, // 设置请求超时时间
});

3. 添加请求拦截器

请求拦截器可以在发送请求之前对请求进行处理，例如添加认证令牌、修改请求头等：

// 添加请求拦截器
request.interceptors.request.use(function (config) {// 在发送请求之前做些什么// 例如，添加认证令牌config.headers['Authorization'] = 'Bearer your-token';return config;},function (error) {// 对请求错误做些什么return Promise.reject(error);}
);

4. 添加响应拦截器

响应拦截器可以在收到响应后对响应数据进行处理，例如统一处理错误信息、转换响应数据格式等：

// 添加响应拦截器
request.interceptors.response.use(function (response) {// 2xx 范围内的状态码都会触发该函数。// 对响应数据做点什么return response.data; // 直接返回响应数据},function (error) {// 超出 2xx 范围的状态码都会触发该函数。// 对响应错误做点什么console.error('请求失败:', error);return Promise.reject(error);}
);

5. 导出 Axios 实例

将配置好的 Axios 实例导出，方便在其他地方使用：

// 导出
export default request;

6.总结实例配置的代码

总结下来整体实例配置的代码如下

// 引入
import axios from "axios";// 创建实例
const request = axios.create({baseURL: 'http://localhost:8000/',timeout: 3000000,
})// 添加请求拦截器
request.interceptors.request.use(function (config) {// 在发送请求之前做些什么return config;}, function (error) {// 对请求错误做些什么return Promise.reject(error);});// 添加响应拦截器
request.interceptors.response.use(function (response) {// 2xx 范围内的状态码都会触发该函数。// 对响应数据做点什么return response;}, function (error) {// 超出 2xx 范围的状态码都会触发该函数。// 对响应错误做点什么return Promise.reject(error);});// 导出
export default request

三、使用 Axios 实例

在你的项目中，你可以通过导入这个配置好的 Axios 实例来发送请求。例如：

import request from './path/to/your/axios-instance';// 发送 GET 请求
request.get('/some-endpoint').then(response => {console.log('响应数据:', response);}).catch(error => {console.error('请求错误:', error);});// 发送 POST 请求
request.post('/some-endpoint', {key: 'value'
}).then(response => {console.log('响应数据:', response);}).catch(error => {console.error('请求错误:', error);});