快捷導(dǎo)航

Vue3全局配置Axios并解決跨域請求問題示例詳解

更新時間：2023年11月06日 09:30:51 作者：Issac-Clarke

axios 是一個基于promise的HTTP庫,支持promise所有的API,本文給大家介紹Vue3全局配置Axios并解決跨域請求問題,內(nèi)容從axios部署開始到解決跨域問題,感興趣的朋友一起看看吧

背景

對于前后端分離項目，前端和后端端口不能重復(fù)，否則會導(dǎo)致前端或者后端服務(wù)起不來。例如前端訪問地址為： http://localhost:8080/ ，后端訪問地址為 http://localhost:8081/ 。后端寫好Controller，當(dāng)用Axios訪問該接口時，將會報錯：

Access to XMLHttpRequest at ' http://localhost:8081/login ' from origin ' http://localhost:8080 ' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.

本文內(nèi)容從axios部署開始到解決跨域問題。

前端: Vue3；Axios 1.6.0 ；Element-Plus
后端：Springboot 2.7.14

這里提供兩種解決方案，都是基于后端跨域訪問的配置，前端不作任何允許跨域訪問的設(shè)置，因為試過無效。

一、部署Axios

Axios的基本介紹：
（1）axios 是一個基于promise的HTTP庫，支持promise所有的API
（2）瀏覽器端/node端（服務(wù)器端）都可以使用，瀏覽器中創(chuàng)建XMLHttpRequests
（3）支持請求／響應(yīng)攔截器
（4）它可以轉(zhuǎn)換請求數(shù)據(jù)和響應(yīng)數(shù)據(jù)，并對響應(yīng)回來的內(nèi)容自動轉(zhuǎn)換成 JSON類型的數(shù)據(jù)
（5）批量發(fā)送多個請求
（6）安全性更高，客戶端支持防御XSRF

1. npm 安裝 axios

npm install axios

2. 創(chuàng)建 request.js，創(chuàng)建axios實例

在項目根目錄下，也就是src目錄下創(chuàng)建文件夾api/，并創(chuàng)建request.js ，該js用于創(chuàng)建axios實例。

import axios from "axios";
const api = axios.create(
	{ 
		baseURL: "http://localhost:8081", //這里配置的是后端服務(wù)提供的接口
		timeout: 1000 
	}
);
export default api;

在這里，我們自定義axois實例化對象，配置了默認(rèn)的訪問i后端ip和端口等，并在末尾使用export 導(dǎo)出api配置，便于在其他單文件中引入 request.js.

3. 在main.js中全局注冊axios

import { createApp } from "vue";
import App from "./App.vue";
import router from "./router";
import axios from "./api/request.js"; //引入request.js
import "element-plus/dist/index.css";
import ElementPlus from "element-plus";
const app = createApp(App);
app.use(router);
app.use(ElementPlus);
app.provide("$axios", axios);
app.mount("#app");
// 全局掛載 axios
app.config.globalProperties.$axios = axios; //配置axios的全局引用

注意，import axois，我們引入的不是官方的aoixs庫，而是自定義的axios.

4. 在頁面中使用axios

本頁面使用的是Element-plus UI，定義一個點擊事件:

 <el-button class="login_button" type="primary" @click="login"
      >登錄</el-button>
<script setup>
import { reactive } from "vue";
import api from "@/api/request.js"; //引入api
//測試請求方法
const login = function () {
  api({ url: "/test", method: "get" }).then((res) => {
  alert("請求成功!");
  console.log(res);
   		}
   );

Axios是支持Promise API的，不熟悉的朋友可以看：Promise API 格式

二、后端解決跨域請求問題

下面是后端解決Axios解決跨域請求的兩種方式。

方法一解決單Contoller跨域訪問

方案一：在需要訪問的Controller接口上添加注解：

@CrossOrigin(origins ="*" ,maxAge = 3600)
    @GetMapping("/test")
    public ApiResult test() {
        return ApiResultHandler.buildApiResult(200, "hello!", null);
    }

這種方式需要每個訪問接口都需要添加，比較繁瑣。

方法二全局解決跨域問題

方案二：配置跨域請求配置類

自己創(chuàng)建一個confg包，創(chuàng)建CorsConfig類。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.filter.CorsFilter;
@Configuration
public class CorsConfig {
    /**
     * 當(dāng)前跨域請求最大有效時長。這里默認(rèn)1天
     */
    private static final long MAX_AGE = 24 * 60 * 60;
    @Bean
    public CorsFilter corsFilter() {
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        CorsConfiguration corsConfiguration = new CorsConfiguration();
        // 1 設(shè)置訪問源地址
        corsConfiguration.addAllowedOrigin("*");
        // 2 設(shè)置訪問源請求頭
        corsConfiguration.addAllowedHeader("*");
        // 3 設(shè)置訪問源請求方法
        corsConfiguration.addAllowedMethod("*");
        corsConfiguration.setMaxAge(MAX_AGE);
        // 4 對接口配置跨域設(shè)置
        source.registerCorsConfiguration("/**", corsConfiguration);
        return new CorsFilter(source);
    }
}

這個配置好了就可以了，其他的不需要動。

結(jié)果：