第1章 一次请求的旅程

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

这门课不从语法表开始,而从浏览器里的一次点击开始。你点下“第一章”,页面要显示标题、正文、练习题;这些内容不在 HTML 文件里,而在几百公里外的数据库里。它们是怎么过来的?

把这条路径走通,你就同时理解了前端、后端、接口、数据库和 Nginx。后面 16 章,只是把这条路径上的每一段拆开,放大,动手做一遍。

同一套数据,两种职责浏览器(前端)Vue 3 + Vite模板与组件页面状态与交互表单校验与提示调用接口、渲染 JSON对用户可见的一切服务器(后端)Spring Boot + JPA接收请求、校验参数业务规则与权限事务、数据一致性读写数据库、返回 JSON对数据负责的一切HTTP 请求GET /api/...JSON 响应{ code, data }前端不信任用户输入,后端不信任前端校验;两边各自守住自己的边界。换一个客户端(小程序、App),后端接口仍然可以复用。
图 1-1 前后端分工:一个负责看见,一个负责正确

1.1 为什么要分前端和后台

最早的网站是“一张 HTML 配一张图”。用户请求 /index.html,服务器把文件原样发回来,浏览器负责显示。这种站点叫静态网站,优点是简单,缺点是内容写死在文件里:改一个价格要改 HTML,多一个用户要复制一份页面。

后来的网站需要登录、搜索、下单、分页,页面内容必须根据数据和用户变化。于是出现了两种分工:

  • 前端:在浏览器里运行,负责页面结构、样式、交互,以及把后端返回的数据填到页面上。
  • 后端:在服务器上运行,负责身份、权限、业务规则、事务和数据库读写。

分工的直接好处是“同一套数据,多个界面”。PC 网页、微信小程序、手机 App 可以各自做界面,但都调用同一组 HTTP 接口。接口返回的不是网页,而是 JSON 数据。

{
  "code": "200",
  "message": "ok",
  "data": {
    "courseId": 39,
    "name": "前后端穿透",
    "chapterCount": 17
  }
}

这段“键值对”就是前后端之间的共同语言。前端认识它,后端生成它,双方不需要知道对方用什么框架。

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 一次请求的六个站点

以“打开课程章节”为例,完整链路是这样的:

  1. 用户在章节列表点击“第一章”,Vue 的事件处理函数被调用;
  2. 前端用 axios 发 GET /api/chapters?courseId=39;
  3. 请求先到 Nginx。Nginx 判断这是 /api,转发给本机的 Spring Boot;
  4. Spring Boot 的 Controller 接住请求,把 courseId 交给 Service;
  5. Service 调 Repository,Repository 生成 SQL,从 MySQL 查出章节;
  6. 结果沿原路返回,变成 JSON;Vue 把数组渲染成列表。
一次点击,穿过六个站点1. 用户点击Vue 事件处理2. axios发 HTTP 请求3. Nginx静态资源 / 反向代理4. Controller接参数、做校验5. Service业务规则、事务6. RepositoryJPA 读写MySQL表与索引Vue 重新渲染DOM 更新返回时顺序反过来:MySQL → Repository → Service → Controller → JSON → Vue。任何一段断了,用户看到的就是白屏、转圈或 502。记住这条链路,后面每一章都只是把其中一段拆开讲。
图 1-2 从点击到渲染:请求去,响应回

这条链路里,前端和后端只在一个地方握手:接口契约。前端要知道“传什么参数、返回什么结构”,后端要知道“谁来调用、失败怎么表示”。契约稳定,两边可以独立开发;契约一改,两边一起坏。

先定契约,再写代码。 本章项目会先约定 { code, message, data } 这种统一响应结构,后面所有接口都遵守它。

1.4 前端到底负责什么

“前端就是画页面”是十年前的说法。今天的前端至少负责五件事:

  • 视图:HTML 结构、CSS 布局、响应式适配;
  • 状态:当前选中的课程、章节、页签、加载中/失败状态;
  • 交互:点击、输入、拖拽、键盘、表单校验;
  • 通信:调用接口、处理超时、重试、取消请求;
  • 体验:骨架屏、空状态、错误提示、无障碍。

但前端有一条硬边界:前端校验只是体验,不是安全。用户可以在浏览器里改 JavaScript、改请求参数,甚至绕过整个页面直接调接口。所以“价格不能小于 0”“只能改自己的订单”这类规则,必须由后端再校验一次。

1.5 后端到底负责什么

后端也不是“把数据库包一层”。它至少负责:

  • 身份:你是谁,登录态是否有效;
  • 权限:你能不能看这门课、能不能改这条记录;
  • 业务规则:下单要扣库存、学习记录要防重复、文件只能传允许的类型;
  • 数据一致性:一次操作涉及多张表时,要么全成功,要么全回滚;
  • 性能与稳定:索引、分页、缓存、限流、日志、监控。

后端的价值不在“能返回数据”,而在“返回对的数据,并且在出错时不出脏数据”。

1.6 本课程做什么项目

我们做一个“学习平台”:课程列表、章节树、章节正文、练习题、登录、文件上传、后台管理。功能不追求多,但每条链路都走完整。

层技术在本课程中的角色
前端Vue 3 + Vite + Vue Router + axios页面、组件、路由、接口调用
后端Spring Boot 2.3 + Java 17REST 接口、业务、会话
数据Spring Data JPA + MySQL实体映射、查询、事务
部署Nginx + systemd静态资源、反向代理、HTTPS

课程顺序按“请求的路径”安排:先理解链路(第 1 章),再学前端的页面与组件(第 2–7 章),然后进入后端(第 8–13 章),最后部署与综合项目(第 14–16 章),附录补 ES6。

1.7 五个常见误解

  1. “会 Vue 就会全栈”:Vue 只解决视图层。接口、数据库、部署、安全,都是另一套知识。
  2. “后端就是增删改查”:CRUD 是入口,真正难的是权限、事务、并发、失败处理。
  3. “接口返回 200 就是成功”:有些系统把业务失败也包在 200 里,必须看 code 字段。本课程统一用 HTTP 状态码 + 业务 code 双重表达。
  4. “前端校验过了,后端不用校验”:前端校验可以被绕过,后端校验才是最后一道门。
  5. “部署是运维的事”:你不懂 Nginx 和进程管理,接口在本机能跑,上线就 502。

1.8 本章练习

  1. 打开你常用的一个网站,按 F12 进入 Network,刷新页面,找出一个 XHR/Fetch 请求,记录它的方法、URL、状态码、响应 JSON 的顶层字段。
  2. 画出这个请求从浏览器到数据库再返回的路径,标出你认为最可能出问题的一段。
  3. 用一句话解释:为什么“前端校验”不能代替“后端校验”。

下一章,我们先把前端工程跑起来。你不需要先学完 JavaScript,遇到不认识的语法,附录 ES6 有速查。

《前后端穿透》常见问题

「前后端穿透」这门课讲什么?

以一次请求的旅程为主线,从 Vue 页面、axios、Spring Boot Controller、JPA 与 MySQL 一直讲到 Nginx 部署,17 章把前端、后端和上线串成一条完整链路。

学这门课需要什么基础?

需要 HTML、CSS、JavaScript 基础,了解 Java 语法即可。课程从 Vue 工程和 Spring Boot 工程搭建讲起,每章都配可运行代码和练习题,遇到问题可以在线运行验证。

学完能做出什么?

能独立完成一个前后端分离的学习平台:页面路由、接口联调、登录鉴权、文件上传、数据库读写,以及用 Nginx 部署上线和排查常见错误。