第16章 调试与上线

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

会写代码只是入门,会定位问题才是工程能力。这一章给你一套从现象到根因的顺序,避免“到处改一点,碰巧好了”。

先定位层,再定位行页面不对Network 有红色请求?看状态码与响应体Network 全绿?看 Console 与 Vue 状态4xx:参数 / 权限5xx:看后端日志数据为空 / 字段名错模板或响应结构问题顺序:先证明“请求有没有发出去”,再证明“后端有没有返回”,最后才怀疑“页面有没有渲染”。不要一上来就改代码;先让证据说话。
图 16-1 前端排错决策树

16.1 先分层,不要先改代码

看到“页面没数据”,先判断是哪一层:

  1. 浏览器有没有发出请求?(Network)
  2. 请求到了 Nginx 吗?(access.log)
  3. Nginx 转给后端了吗?(error.log、后端日志)
  4. 后端查数据库成功了吗?(SQL 日志、EXPLAIN)
  5. 响应回到前端,渲染了吗?(Console、Vue Devtools)

每一步都有证据,不要跳步。最常见的浪费时间,是在前端改半天,最后发现后端 500。

16.2 浏览器 Network 面板

看什么说明
Status200/401/404/500,先看状态码
Request URL路径、参数是否正确
MethodGET/POST 是否和后端一致
Payload请求体有没有发出去
Response后端返回的 JSON 或错误页
TimingDNS、连接、等待、下载各多久

如果请求根本没出现,问题在点击事件、路由或 JS 报错;如果出现了但红色,看状态码;如果 200 但页面没变,看 Response 和渲染逻辑。

16.3 curl:绕开浏览器

浏览器有缓存、CORS、cookie,容易干扰。用 curl 直接打接口,能快速判断是不是后端问题。

curl -i http://127.0.0.1:5000/api/courses
 
curl -i -X POST http://127.0.0.1:5000/api/login \
  -H "Content-Type: application/json" \
  -d '{"username":"demo","password":"123456"}'
 
curl -I https://www.example.com/

在服务器上 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 的根因。

java.lang.NullPointerException: Cannot invoke "Course.getName()" because "course" is null
  at cn.jssp.service.CourseService.detail(CourseService.java:42)
  ...
Caused by: ...

上面说明第 42 行拿到的 course 是 null。不要从堆栈最后一行开始看,也不要只看“Exception”三个字。

16.6 跨域与 cookie

跨域报错要区分“预检失败”和“业务 401”。预检是 OPTIONS 请求,后端要允许来源、方法、头;带 cookie 时不能把 Access-Control-Allow-Origin 写成 *。

// 前端
axios.defaults.withCredentials = true
 
// 后端(Spring)
response.setHeader("Access-Control-Allow-Origin", "https://www.example.com");
response.setHeader("Access-Control-Allow-Credentials", "true");

生产环境最省事的是同源反代:前端和 /api 在同一个域名下,不需要 CORS。

16.7 慢:先量再优化

不要凭感觉加缓存。先用时间线量:DNS、连接、TTFB、下载。后端再用日志量:进入时间、SQL 耗时、序列化耗时。

long start = System.currentTimeMillis();
List<Chapter> list = repository.findByCourseId(courseId);
log.info("query cost={}ms size={}", System.currentTimeMillis() - start, list.size());

常见原因:查了不需要的大字段、N+1、缺索引、返回巨大 JSON、同步调用外部服务。先解决最大的那个,不要一次改十处。

16.8 上线前检查

  1. 后端日志无 Exception,错误日志有轮转。
  2. 数据库有备份,恢复流程演练过。
  3. HTTPS 证书有效期足够,HTTP 跳转正常。
  4. 静态资源带 hash,缓存策略正确。
  5. 关键接口有监控/巡检,失败能告警。
  6. 回滚方案明确:上一个 jar、上一版 dist 在哪。
上线不是“传上去看看”。没有回滚方案的上线,是在赌。

16.9 本章练习

  1. 故意把后端停掉,观察 502,并从 error.log 找到原因。
  2. 把接口超时改成 1 秒,制造 504,学会看后端慢日志。
  3. 写一份自己的上线检查清单,至少 8 条。

最后一章是附录:ES6 常用语法速查,方便你读现代前端代码。