第16章 调试与上线
会写代码只是入门,会定位问题才是工程能力。这一章给你一套从现象到根因的顺序,避免“到处改一点,碰巧好了”。
16.1 先分层,不要先改代码
看到“页面没数据”,先判断是哪一层:
- 浏览器有没有发出请求?(Network)
- 请求到了 Nginx 吗?(access.log)
- Nginx 转给后端了吗?(error.log、后端日志)
- 后端查数据库成功了吗?(SQL 日志、EXPLAIN)
- 响应回到前端,渲染了吗?(Console、Vue Devtools)
每一步都有证据,不要跳步。最常见的浪费时间,是在前端改半天,最后发现后端 500。
16.2 浏览器 Network 面板
| 看什么 | 说明 |
|---|---|
| Status | 200/401/404/500,先看状态码 |
| Request URL | 路径、参数是否正确 |
| Method | GET/POST 是否和后端一致 |
| Payload | 请求体有没有发出去 |
| Response | 后端返回的 JSON 或错误页 |
| Timing | DNS、连接、等待、下载各多久 |
如果请求根本没出现,问题在点击事件、路由或 JS 报错;如果出现了但红色,看状态码;如果 200 但页面没变,看 Response 和渲染逻辑。
16.3 curl:绕开浏览器
浏览器有缓存、CORS、cookie,容易干扰。用 curl 直接打接口,能快速判断是不是后端问题。
在服务器上 curl 本机 5000 通、公网 502,说明 Nginx 或防火墙有问题;本机也不通,说明后端没起来或端口不对。
16.4 常见状态码
| 码 | 含义 | 优先排查 |
|---|---|---|
| 400 | 参数不合法 | 请求体、类型、校验注解 |
| 401 | 未登录/令牌失效 | cookie、Authorization、拦截器 |
| 403 | 已登录但无权限 | 角色、资源归属 |
| 404 | 路径不存在 | Nginx location、后端映射 |
| 413 | 请求体太大 | client_max_body_size、multipart |
| 500 | 后端异常 | 看堆栈第一行 caused by |
| 502 | 网关连不上后端 | 后端进程、端口、防火墙 |
| 504 | 后端超时 | 慢 SQL、死循环、外部调用 |
16.5 读堆栈
500 的堆栈很长,但只需要看三处:最上面的异常类型、第一行业务代码、Caused by 的根因。
上面说明第 42 行拿到的 course 是 null。不要从堆栈最后一行开始看,也不要只看“Exception”三个字。
16.6 跨域与 cookie
跨域报错要区分“预检失败”和“业务 401”。预检是 OPTIONS 请求,后端要允许来源、方法、头;带 cookie 时不能把 Access-Control-Allow-Origin 写成 *。
生产环境最省事的是同源反代:前端和 /api 在同一个域名下,不需要 CORS。
16.7 慢:先量再优化
不要凭感觉加缓存。先用时间线量:DNS、连接、TTFB、下载。后端再用日志量:进入时间、SQL 耗时、序列化耗时。
常见原因:查了不需要的大字段、N+1、缺索引、返回巨大 JSON、同步调用外部服务。先解决最大的那个,不要一次改十处。
16.8 上线前检查
- 后端日志无 Exception,错误日志有轮转。
- 数据库有备份,恢复流程演练过。
- HTTPS 证书有效期足够,HTTP 跳转正常。
- 静态资源带 hash,缓存策略正确。
- 关键接口有监控/巡检,失败能告警。
- 回滚方案明确:上一个 jar、上一版 dist 在哪。
16.9 本章练习
- 故意把后端停掉,观察 502,并从 error.log 找到原因。
- 把接口超时改成 1 秒,制造 504,学会看后端慢日志。
- 写一份自己的上线检查清单,至少 8 条。
最后一章是附录:ES6 常用语法速查,方便你读现代前端代码。
《前后端穿透》课程目录
从浏览器里的一次点击出发,把 Vue 3 前端、Spring Boot 后端、MySQL 与 Nginx 串成一条完整链路