第7章 axios 与接口

第 7 节 / 共 17 节 课程:前后端穿透

前端真正开始“有用”,是从能拿到后端数据那一刻。这一章讲清楚:一个请求发出去之前要约定什么,axios 怎么配,加载/失败/空数据怎么处理,跨域为什么发生。

一次接口调用的时序浏览器axiosNginxControllerMySQL1. 调用 api2. HTTPS3. /api 反代4. SQL5. 结果集6. JSON7. 响应8. then/await任意一步失败,都要能说清楚:是网络、是 4xx、是 5xx,还是数据为空。
图 7-1 axios、Nginx、Controller、MySQL 的时序

7.1 先定接口契约

不要前后端各写各的,最后靠猜。每个接口至少约定六件事:

项目例子说明
方法GET / POST / PUT / DELETE查询用 GET,新增用 POST,修改用 PUT/PATCH,删除用 DELETE
路径/api/chapters?courseId=39统一前缀,资源用复数
请求参数courseId=39放在 query、path 还是 body,要写清楚
响应结构{ code, info, data }成功和失败都遵循同一套外壳
错误码404 / 401 / 500业务错误也要有可判断的 code
分页/排序page, size, sort列表接口提前定,避免后面改

本站后端统一返回 { code, info, data }。code 是字符串,例如 "200";info 是提示;data 是真正的数据。前端只认这个结构,页面上就不需要到处判断。代码示例:

{
  "code": "200",
  "info": null,
  "data": [
    { "code": "010000", "name": "一次请求的旅程" }
  ]
}

7.2 安装与最小请求

npm install axios
import axios from 'axios'
 
async function loadCourses() {
    const res = await axios.get('/api/getCourses')
    console.log(res.data)
}
 
loadCourses()

浏览器里直接打开页面时,/api 会被当成当前域名下的路径。开发阶段通常由 Vite 代理到后端,生产阶段由 Nginx 反代。不要在每个请求里写死 http://localhost:5000。

7.3 统一实例与拦截器

项目里不要到处 axios.get。建一个实例,统一 baseURL、超时、token 和错误处理。

// src/api/http.js
import axios from 'axios'
 
const http = axios.create({
    baseURL: '/api',
    timeout: 10000
})
 
http.interceptors.request.use(config => {
    const token = localStorage.getItem('token')
    if (token) config.headers.Authorization = 'Bearer ' + token
    return config
})
 
http.interceptors.response.use(
res => res.data,
err => {
    if (err.response && err.response.status === 401) {
        localStorage.removeItem('token')
        location.href = '/login'
    }
    return Promise.reject(err)
}
)
 
export default http

响应拦截器返回 res.data 后,业务代码拿到的就是 { code, info, data },不用每次写 res.data.data。

拦截器里不要吞掉错误。要么提示后 reject,要么交给调用方处理;只 console.log 会让页面一直停在 loading。

7.4 GET、POST 与参数位置

// GET:参数放 params,axios 会自动拼 query
const list = await http.get('/chapters', { params: { courseId: 39 } })
 
// POST:JSON body
const saved = await http.post('/chapter', {
    courseId: 39,
    code: '010100',
    name: '第一个页面'
})
 
// 路径参数
const detail = await http.get('/chapter/010100')

常见错误是把 GET 的参数塞进 body,或者 POST 时后端期望表单却发了 JSON。方法、参数位置、Content-Type 三者必须和接口文档一致。

7.5 加载、失败、空数据

一个列表页面至少有四种状态:加载中、成功有数据、成功但为空、失败。只写成功分支,用户会以为页面卡死。

<template>
  <p v-if="loading">加载中...</p>
  <p v-else-if="error" class="error">{{ error }}</p>
  <p v-else-if="!list.length">暂无课程</p>
  <ul v-else>
    <li v-for="c in list" :key="c.id">{{ c.name }}</li>
  </ul>
</template>
 
<script setup>
import { ref, onMounted } from 'vue'
import http from '../api/http'
 
const loading = ref(true)
const error = ref('')
const list = ref([])
 
onMounted(async () => {
  try {
    const res = await http.get('/getCourses')
    list.value = res.data || []
  } catch (e) {
    error.value = '课程加载失败,请稍后重试'
  } finally {
    loading.value = false
  }
})
</script>

try/catch/finally 是最小要求:失败要写 error,结束要关 loading。不要只写 try 不写 finally。

7.6 竞态:快速切换课程

用户连续点课程 A、B,A 的请求比 B 慢,最后页面可能显示 A 的数据。这叫竞态。两种解法:取消上一个请求,或者只接受最后一次请求的结果。

let seq = 0
 
async function load(id) {
    const current = ++seq
    const res = await http.get('/chapters', { params: { courseId: id } })
    if (current !== seq) return
    list.value = res.data
}

也可以用 AbortController 真正取消请求。无论哪种,思路都是“旧请求的结果不能覆盖新请求”。

7.7 跨域与代理

浏览器有同源策略:协议、域名、端口三者任一不同就是跨域。开发时页面在 localhost:5173,后端在 localhost:5000,所以跨域。

// vite.config.js
export default {
    server: {
        proxy: {
            '/api': {
                target: 'http://localhost:5000',
                changeOrigin: true
            }
        }
    }
}

生产环境由 Nginx 把 /api 转发到后端,同源,不需要 CORS。若确实要跨域,后端必须返回正确的 Access-Control-Allow-Origin,不能靠前端绕过。

现象原因处理
浏览器报 CORS跨域且后端没放行开发用代理,生产用同源反代
404路径写错或方法不对对照接口文档,看 Network
401未登录或 token 过期清 token,跳登录
500后端异常看后端日志,不要只改前端

7.8 把接口收进 api 目录

页面里不要散落 URL。按业务建 src/api/course.js、chapter.js、quiz.js,页面只调用函数。

// src/api/course.js
import http from './http'
 
export function getCourses() {
    return http.get('/getCourses')
}
 
export function getChapters(courseId) {
    return http.get('/chapters', { params: { courseId } })
}
// 页面
import { getCourses } from '../api/course'
const res = await getCourses()

7.9 本章练习

  1. 给课程列表加上“加载中 / 空 / 失败 / 成功”四种状态。
  2. 把请求封装到 src/api/course.js,页面不再直接写 URL。
  3. 模拟接口延迟 2 秒,快速点两门课,观察竞态并修复。

下一章进入后端:Spring Boot 工程怎么建,启动类、配置文件、分层各做什么。