前端真正开始“有用”,是从能拿到后端数据那一刻。这一章讲清楚:一个请求发出去之前要约定什么,axios 怎么配,加载/失败/空数据怎么处理,跨域为什么发生。
图 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 安装与最小请求
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 和错误处理。
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 与参数位置
const list = await http.get('/chapters', { params: { courseId: 39 } })
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,所以跨域。
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,页面只调用函数。
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 本章练习
- 给课程列表加上“加载中 / 空 / 失败 / 成功”四种状态。
- 把请求封装到
src/api/course.js,页面不再直接写 URL。
- 模拟接口延迟 2 秒,快速点两门课,观察竞态并修复。
下一章进入后端:Spring Boot 工程怎么建,启动类、配置文件、分层各做什么。