第1章 一次请求的旅程
这门课不从语法表开始,而从浏览器里的一次点击开始。你点下“第一章”,页面要显示标题、正文、练习题;这些内容不在 HTML 文件里,而在几百公里外的数据库里。它们是怎么过来的?
把这条路径走通,你就同时理解了前端、后端、接口、数据库和 Nginx。后面 16 章,只是把这条路径上的每一段拆开,放大,动手做一遍。
1.1 为什么要分前端和后台
最早的网站是“一张 HTML 配一张图”。用户请求 /index.html,服务器把文件原样发回来,浏览器负责显示。这种站点叫静态网站,优点是简单,缺点是内容写死在文件里:改一个价格要改 HTML,多一个用户要复制一份页面。
后来的网站需要登录、搜索、下单、分页,页面内容必须根据数据和用户变化。于是出现了两种分工:
- 前端:在浏览器里运行,负责页面结构、样式、交互,以及把后端返回的数据填到页面上。
- 后端:在服务器上运行,负责身份、权限、业务规则、事务和数据库读写。
分工的直接好处是“同一套数据,多个界面”。PC 网页、微信小程序、手机 App 可以各自做界面,但都调用同一组 HTTP 接口。接口返回的不是网页,而是 JSON 数据。
这段“键值对”就是前后端之间的共同语言。前端认识它,后端生成它,双方不需要知道对方用什么框架。
1.2 浏览器和服务器之间发生了什么
当你在地址栏输入一个网址,或者点击一个按钮,浏览器会做一件事:发一个 HTTP 请求。请求里至少有四样东西。
| 部分 | 例子 | 作用 |
|---|---|---|
| 方法 | GET / POST / PUT / DELETE | 告诉服务器“要读”还是“要写” |
| 地址 | https://www.codessp.cn/api/chapters?courseId=39 | 要访问的资源 |
| 请求头 | Content-Type: application/json | 说明数据格式、身份、缓存策略 |
| 请求体 | {"username":"tom","password":"..."} | POST/PUT 时携带的数据 |
服务器处理完,返回一个响应。响应也有三样关键信息:状态码、响应头、响应体。
| 状态码 | 含义 | 前端应该怎么做 |
|---|---|---|
| 200 | 成功 | 读取 data,渲染页面 |
| 201 | 创建成功 | 提示保存成功,跳转到详情 |
| 400 | 参数不合法 | 把 message 显示给用户,检查表单 |
| 401 | 未登录或登录过期 | 跳转登录页,不要继续请求 |
| 403 | 已登录但没权限 | 提示无权限,不要反复重试 |
| 404 | 资源不存在 | 显示空状态或返回列表 |
| 500 | 服务器内部错误 | 提示稍后再试,同时看后端日志 |
| 502 / 504 | 网关后面的服务不可用或超时 | 检查后端进程、端口、Nginx 配置 |
这几种状态码不是“背下来就行”,而是排查问题的顺序:先看请求有没有发出去,再看服务器有没有接住,最后才看页面有没有渲染。
1.3 一次请求的六个站点
以“打开课程章节”为例,完整链路是这样的:
- 用户在章节列表点击“第一章”,Vue 的事件处理函数被调用;
- 前端用 axios 发
GET /api/chapters?courseId=39; - 请求先到 Nginx。Nginx 判断这是
/api,转发给本机的 Spring Boot; - Spring Boot 的 Controller 接住请求,把
courseId交给 Service; - Service 调 Repository,Repository 生成 SQL,从 MySQL 查出章节;
- 结果沿原路返回,变成 JSON;Vue 把数组渲染成列表。
这条链路里,前端和后端只在一个地方握手:接口契约。前端要知道“传什么参数、返回什么结构”,后端要知道“谁来调用、失败怎么表示”。契约稳定,两边可以独立开发;契约一改,两边一起坏。
{ code, message, data } 这种统一响应结构,后面所有接口都遵守它。1.4 前端到底负责什么
“前端就是画页面”是十年前的说法。今天的前端至少负责五件事:
- 视图:HTML 结构、CSS 布局、响应式适配;
- 状态:当前选中的课程、章节、页签、加载中/失败状态;
- 交互:点击、输入、拖拽、键盘、表单校验;
- 通信:调用接口、处理超时、重试、取消请求;
- 体验:骨架屏、空状态、错误提示、无障碍。
但前端有一条硬边界:前端校验只是体验,不是安全。用户可以在浏览器里改 JavaScript、改请求参数,甚至绕过整个页面直接调接口。所以“价格不能小于 0”“只能改自己的订单”这类规则,必须由后端再校验一次。
1.5 后端到底负责什么
后端也不是“把数据库包一层”。它至少负责:
- 身份:你是谁,登录态是否有效;
- 权限:你能不能看这门课、能不能改这条记录;
- 业务规则:下单要扣库存、学习记录要防重复、文件只能传允许的类型;
- 数据一致性:一次操作涉及多张表时,要么全成功,要么全回滚;
- 性能与稳定:索引、分页、缓存、限流、日志、监控。
后端的价值不在“能返回数据”,而在“返回对的数据,并且在出错时不出脏数据”。
1.6 本课程做什么项目
我们做一个“学习平台”:课程列表、章节树、章节正文、练习题、登录、文件上传、后台管理。功能不追求多,但每条链路都走完整。
| 层 | 技术 | 在本课程中的角色 |
|---|---|---|
| 前端 | Vue 3 + Vite + Vue Router + axios | 页面、组件、路由、接口调用 |
| 后端 | Spring Boot 2.3 + Java 17 | REST 接口、业务、会话 |
| 数据 | Spring Data JPA + MySQL | 实体映射、查询、事务 |
| 部署 | Nginx + systemd | 静态资源、反向代理、HTTPS |
课程顺序按“请求的路径”安排:先理解链路(第 1 章),再学前端的页面与组件(第 2–7 章),然后进入后端(第 8–13 章),最后部署与综合项目(第 14–16 章),附录补 ES6。
1.7 五个常见误解
- “会 Vue 就会全栈”:Vue 只解决视图层。接口、数据库、部署、安全,都是另一套知识。
- “后端就是增删改查”:CRUD 是入口,真正难的是权限、事务、并发、失败处理。
- “接口返回 200 就是成功”:有些系统把业务失败也包在 200 里,必须看
code字段。本课程统一用 HTTP 状态码 + 业务 code 双重表达。 - “前端校验过了,后端不用校验”:前端校验可以被绕过,后端校验才是最后一道门。
- “部署是运维的事”:你不懂 Nginx 和进程管理,接口在本机能跑,上线就 502。
1.8 本章练习
- 打开你常用的一个网站,按 F12 进入 Network,刷新页面,找出一个 XHR/Fetch 请求,记录它的方法、URL、状态码、响应 JSON 的顶层字段。
- 画出这个请求从浏览器到数据库再返回的路径,标出你认为最可能出问题的一段。
- 用一句话解释:为什么“前端校验”不能代替“后端校验”。
下一章,我们先把前端工程跑起来。你不需要先学完 JavaScript,遇到不认识的语法,附录 ES6 有速查。
《前后端穿透》常见问题
「前后端穿透」这门课讲什么?
以一次请求的旅程为主线,从 Vue 页面、axios、Spring Boot Controller、JPA 与 MySQL 一直讲到 Nginx 部署,17 章把前端、后端和上线串成一条完整链路。
学这门课需要什么基础?
需要 HTML、CSS、JavaScript 基础,了解 Java 语法即可。课程从 Vue 工程和 Spring Boot 工程搭建讲起,每章都配可运行代码和练习题,遇到问题可以在线运行验证。
学完能做出什么?
能独立完成一个前后端分离的学习平台:页面路由、接口联调、登录鉴权、文件上传、数据库读写,以及用 Nginx 部署上线和排查常见错误。
《前后端穿透》课程目录
从浏览器里的一次点击出发,把 Vue 3 前端、Spring Boot 后端、MySQL 与 Nginx 串成一条完整链路