罗罗编程学习记录
本页内容 展开查看

07.7 阶段 6:鉴权、安全、测试与可观测

所属:全栈开发面试题库 / 学习路径 / 07 Node.js 全栈

本页目录

一、阶段定位

阶段 5 的服务已经能跑业务、存数据,但还"裸奔":谁都能调接口、参数没校验、出问题不知道怎么查。本阶段补齐四件事:鉴权(JWT/Session/OAuth2)、安全防护(helmet/CORS/限流/注入)、测试(Vitest/supertest)、可观测(日志/指标/链路/内存排查)。这是从"能跑"到"能上生产"的最后一道关。

与前后阶段的衔接:往上接 阶段 5 数据层、缓存与队列,鉴权中间件要校验 JWT、查 Redis 会话;往下接 阶段 7 全栈同构、部署与生产化,日志与指标要在容器里收集、健康检查要配套。

本阶段原有的四个卡点,展开成可判断的现象依据:

  1. 只防 SQL 注入忽略 NoSQL 注入、SSRF 与原型链污染。判断标准:用 Prisma 参数化查询防了 SQL 注入,但 req.body 直接传给 Object.assign 或 $where 没做校验;或接口接收一个 URL 参数直接 fetch(url) 不校验目标。
  2. 测试依赖真实数据库导致用例不稳定。判断标准:跑测试时需要本地 MySQL/Redis,数据互相污染,时过时不过;或每个用例跑完不清理。
  3. 日志只 console.log 无上下文。判断标准:线上报错只看到 Error: xxx,没有 request id、没有 user id、没有时间戳,无法定位是哪次请求。
  4. 线上直接开调试工具长期挂着。判断标准:生产环境用 node --inspect 启动,或把 debug 端口暴露公网,安全与性能都有风险。

二、阶段目标与投入

能力目标(可验证的行为) 验证方式
能用 JWT 做接口鉴权,说明与 Session 的取舍 带 token 访问接口,不带返回 401
能配 helmet、CORS、限流,说明各自作用 响应头有安全头,超量返回 429
能防 SQL 注入、NoSQL 注入、SSRF、原型链污染 恶意输入被拦截
能用 Vitest 写单元测试,用 supertest 写接口测试 npm test 通过,覆盖率报告可看
能用 pino 输出结构化 JSON 日志,带 request id 日志可检索,能关联一次请求
能用 clinic doctor 或 --inspect 定位 CPU 与内存问题 输出火焰图,指出瓶颈函数

建议学时:

  • 全职(每天 4–6 小时):2 周,约 60 小时。鉴权 15 小时、安全 15 小时、测试 15 小时、可观测 15 小时。
  • 在职(每天 2 小时):5–6 周。安全与可观测是面试与线上事故的高频区。

学时分配建议:JWT/Session/OAuth2 20%、Web 安全 25%、测试 20%、日志与链路 15%、性能与内存排查 20%。

三、先修自检

先修项 合格标准 不合格时回到
Express/NestJS 能写中间件与路由 07.5 阶段 4
Redis 能配客户端与缓存 07.6 阶段 5
TypeScript 能写接口与泛型 07.4 阶段 3
HTTP 与 CORS 知道请求头与预检 07.5 阶段 4
命令行 会跑测试脚本 07.3 阶段 2

四、知识地图

模块 知识点 掌握程度 对应题库章节
鉴权 JWT、Session、OAuth2/OIDC、Bearer Token 能讲清原理 06.1 通用后端工程
Web 安全 helmet、CSP、CORS、限流、注入、SSRF、原型污染 能讲清原理 06.1 通用后端工程
参数校验 zod/Joi、schema 校验 会用 06.1 通用后端工程
依赖安全 npm audit、供应链 会用 06.1 通用后端工程
单元测试 Vitest/Jest、Mock、覆盖率 会用 06.1 通用后端工程
接口测试 supertest、断言 会用 06.1 通用后端工程
结构化日志 pino、request id 会用 08.4 CI/CD 与可观测性
链路追踪 OpenTelemetry、trace id 会用 08.4 CI/CD 与可观测性
性能排查 clinic、--inspect、火焰图、堆快照 会用 04.2 Node.js

进度管理建议:JWT、Web 安全、测试、日志必须到"能讲清原理",其余到"会用"。

五、分模块精讲

5.1 JWT、Session 与 OAuth2/OIDC

为什么需要它:接口要知道"谁在访问"。JWT 是无状态令牌,Session 是有状态存储,OAuth2 是第三方授权。选错模型,安全与扩展性都出问题。

核心机制:

  • JWT:Header.Payload.Signature。服务端用密钥签名,客户端每次带 Authorization: Bearer <token>。无状态,服务端不存 session。
  • JWT 缺点:签发后无法主动失效(除非加黑名单 Redis);payload 只是 base64,不能放敏感信息。
  • Session:服务端存会话,前端靠 Cookie 带 session id。有状态,易做单点登出,但多实例要共享存储。
  • OAuth2:授权码模式(最常用):前端跳到授权服务器 → 用户登录 → 回调带 code → 后端换 access_token + id_token。OIDC 在 OAuth2 上加身份信息。
  • 选型:内部系统用 Session;开放 API/多端用 JWT;第三方登录用 OAuth2。

最小可运行示例:

const jwt = require("jsonwebtoken");

// 登录签发
const token = jwt.sign({ sub: user.id, role: "admin" }, process.env.JWT_SECRET, {
  expiresIn: "2h"
});

// 鉴权中间件
function auth(req, res, next) {
  const header = req.headers.authorization;
  if (!header?.startsWith("Bearer ")) return res.sendStatus(401);
  try {
    const payload = jwt.verify(header.slice(7), process.env.JWT_SECRET);
    req.user = payload;
    next();
  } catch {
    return res.sendStatus(401);
  }
}

app.get("/profile", auth, (req, res) => res.json(req.user));

常见坑:

现象 原因 修法
JWT 无法主动登出 无状态 加 Redis 黑名单
payload 放密码 JWT 只是 base64 只放 id/role
密钥硬编码 写死在代码 用环境变量
token 过期时报错 没处理 401 前端跳登录

面试考法:"JWT 与 Session 区别""JWT 怎么主动失效"。答到无状态 vs 有状态;黑名单。

5.2 Web 安全:helmet、CORS、限流与注入

为什么需要它:Node 服务默认没有安全头,注入与 SSRF 是高频漏洞。helmet 一键加安全头,参数校验防注入。

核心机制:

  • helmet:设置 X-Content-Type-Options、X-Frame-Options、CSP 等安全头。
  • CORS:白名单 origin,不要 * 配 credentials。
  • 限流:express-rate-limit,按 IP 或 user 限流。
  • SQL 注入:ORM 参数化查询自动防;不要拼字符串 SQL。
  • NoSQL 注入:MongoDB 里 $where、$gt 注入;用 zod 校验输入类型。
  • SSRF:接口接收 URL 时,禁止访问内网地址(127.0.0.1、10.x、169.254.x)。
  • 原型链污染:Object.assign({}, req.body) 或 merge 把 __proto__ 写进去;用 hasOwnProperty 或冻结。

最小可运行示例:

const express = require("express");
const helmet = require("helmet");
const rateLimit = require("express-rate-limit");
const app = express();

app.use(helmet());
app.use(express.json());

// 限流:每 IP 15 分钟 100 次
app.use(rateLimit({ windowMs: 15 * 60 * 1000, max: 100 }));

// 防 SSRF:校验目标 URL
const { URL } = require("url");
function isSafeUrl(url) {
  const u = new URL(url);
  return !/^(127\.|10\.|192\.168\.|169\.254\.)/.test(u.hostname);
}

常见坑:

现象 原因 修法
X-Frame-Options 缺失 没 helmet 加 helmet()
SQL 注入 拼字符串 SQL 用参数化/ORM
SSRF 打到内网 不校验 URL 加白名单/禁内网段
原型链污染 Object.assign 合并用户输入 用 zod 校验,白名单字段

面试考法:"怎么防 SQL 注入""SSRF 是什么""原型链污染怎么产生"。答到参数化、URL 校验、__proto__ 保护。

5.3 参数校验与依赖供应链

为什么需要它:不信任任何外部输入。zod 定义 schema,自动校验并转类型。依赖漏洞定期审计。

核心机制:

  • zod:定义 schema,parse(req.body),失败抛错。
  • 替代:Joi、class-validator(NestJS)。
  • npm audit:扫描依赖已知 CVE。
  • npm audit fix:自动升级兼容版本。
  • 供应链:锁定版本、用私有 registry、定期审计。

最小可运行示例:

import { z } from "zod";

const UserSchema = z.object({
  name: z.string().min(2).max(50),
  email: z.string().email(),
  age: z.number().int().min(0).max(150)
});

app.post("/user", (req, res) => {
  const result = UserSchema.safeParse(req.body);
  if (!result.success) {
    return res.status(400).json({ errors: result.error.flatten() });
  }
  // result.data 是类型安全的
});

常见坑:

现象 原因 修法
输入类型错导致运行时崩 没校验 用 zod parse
依赖有 CVE 但不知道 没跑 audit CI 加 npm audit

面试考法:"zod 比手写校验好在哪""npm audit 怎么集成 CI"。答到类型自动推断;CI 跑 audit。

5.4 Vitest/Jest 与 supertest 测试

为什么需要它:测试保证重构不破坏功能。单元测试测 Service,接口测试测路由。不要依赖真实数据库。

核心机制:

  • Vitest:Vite 生态测试框架,API 与 Jest 兼容,速度快。
  • 单元测试:it("...", () => { expect(...).toBe(...) })。
  • Mock:vi.fn() 模拟外部依赖;vi.mock("...") 替换模块。
  • 覆盖率:vitest --coverage,看行/分支覆盖率。
  • supertest:用 HTTP 请求测 Express 应用,不需要真起端口。

最小可运行示例:

// sum.test.ts
import { expect, it } from "vitest";
import { sum } from "./sum";

it("adds 1 + 2 = 3", () => {
  expect(sum(1, 2)).toBe(3);
});
// app.test.ts
import request from "supertest";
import { app } from "./app";

it("GET /hello returns 200", async () => {
  const res = await request(app).get("/hello");
  expect(res.status).toBe(200);
  expect(res.body.message).toBe("hi");
});
npx vitest run --coverage

常见坑:

现象 原因 修法
测试时过时过 依赖真实 DB Mock DB 层,用内存库
Mock 不生效 vi.mock 路径错 对齐 import 路径
覆盖率虚高 只跑简单用例 补边界与异常分支

面试考法:"单元测试与接口测试区别""怎么 Mock 数据库"。答到测逻辑 vs 测链路;vi.mock。

5.5 pino 结构化日志

为什么需要它:console.log 输出纯文本,无法检索、无法关联请求。结构化 JSON 日志 + request id 是线上排障基础。

核心机制:

  • pino:高性能 JSON 日志库。
  • 每个请求生成 request id(中间件),挂到日志里。
  • req.log.info("...") 自动带 request id、user id。
  • 日志级别:debug/info/warn/error。
  • 生产不打 debug。

最小可运行示例:

const pino = require("pino");
const express = require("express");
const { v4: uuid } = require("uuid");

const logger = pino({ level: process.env.LOG_LEVEL || "info" });
const app = express();

app.use((req, res, next) => {
  req.log = logger.child({ requestId: uuid(), method: req.method, url: req.url });
  req.log.info("request started");
  next();
});

app.get("/hello", (req, res) => {
  req.log.info("handling hello");
  res.json({ message: "hi" });
});

常见坑:

现象 原因 修法
日志无上下文 用 console.log 用 pino child logger
生产 debug 太多 级别太低 设 LOG_LEVEL=info
敏感信息打日志 直接打 body 脱敏中间件

面试考法:"为什么要结构化日志""request id 作用"。答到可检索;关联一次请求。

5.6 OpenTelemetry 与链路追踪

为什么需要它:微服务/多组件下,一个请求经过 API → DB → Redis → MQ,出问题不知道卡在哪。链路追踪给每个请求一个 trace id,串起各段耗时。

核心机制:

  • OpenTelemetry:埋点 SDK,自动生成 span。
  • trace id:全局唯一,跨服务传递(HTTP header traceparent)。
  • span:一次操作(如 DB 查询),含开始/结束时间、标签。
  • 指标:QPS、延迟直方图、错误率。
  • 后端:Jaeger、Tempo、OTel Collector。

最小可运行示例:

# OTel 自动埋点(Node)
npm install @opentelemetry/api @opentelemetry/auto-instrumentations-node
node -r @opentelemetry/auto-instrumentations-node/register app.js

常见坑:

现象 原因 修法
没看到 trace 没传 traceparent 中间件自动传播
指标缺失 没接 Collector 配 OTEL_EXPORTER_OTLP_ENDPOINT

面试考法:"链路追踪解决什么问题""trace id 怎么传"。答到跨服务定位;HTTP header 传播。

5.7 clinic、--inspect 与内存泄漏排查

为什么需要它:线上慢、内存涨,不能靠猜。clinic doctor 给报告,--inspect 连 Chrome DevTools 看火焰图与堆快照。

核心机制:

  • clinic doctor -- node app.js:跑一段时间,输出健康报告(事件循环延迟、GC、阻塞)。
  • clinic flame -- node app.js:火焰图,看哪个函数占用 CPU 多。
  • node --inspect app.js:Chrome DevTools 连接,看 Performance、Memory。
  • 内存泄漏:拍堆快照(heap snapshot),对比两次,看谁在涨。常见:全局数组、未关闭监听器、缓存无淘汰。

最小可运行示例:

npx clinic doctor -- node app.js
npx clinic flame -- node app.js
# 然后压测
// 典型内存泄漏:全局数组不断 push
const cache = [];
app.get("/add", (req, res) => {
  cache.push(req.query.data); // 永不清理
  res.json({ size: cache.length });
});

常见坑:

现象 原因 修法
内存持续涨不下降 全局数组/缓存无淘汰 加 LRU 上限
CPU 高 某函数循环 看火焰图找热函数
--inspect 暴露公网 安全风险 只在本地开,用 SSH 隧道

面试考法:"怎么定位内存泄漏""火焰图怎么看"。答到堆快照对比;宽函数占比高。

六、分层练习

6.1 复现型

练习 要求 验收标准 预计耗时
JWT 鉴权 写登录签发与鉴权中间件 带 token 通,不带 401 1.5 小时
helmet 与限流 加 helmet 和 rate-limit 响应头有安全头,超量 429 1 小时
zod 校验 给 POST /user 加 zod schema 缺字段返回 400 1 小时
pino 日志 中间件生成 requestId,pino child logger 日志带 requestId 1 小时
单元测试 给一个 sum 函数写 Vitest 测试通过 0.5 小时

6.2 改造型

练习 要求 验收标准 预计耗时
修 SSRF 给定接收 URL 直接 fetch 的接口,加内网校验 访问 127.0.0.1 被拒 1 小时
修原型污染 给定 Object.assign 合并 body 的代码,加白名单 __proto__ 无法写入 1 小时
测试去 DB 给定依赖真实 MySQL 的测试,改成 Mock 无 DB 也能跑 2 小时
日志加上下文 把 console.log 全换成 pino 日志 JSON 可检索 1.5 小时
修内存泄漏 给定全局数组 push 的代码,加 LRU 内存稳定 1.5 小时

6.3 设计型

练习 要求 验收标准 预计耗时
完整鉴权 注册/登录/JWT/刷新 token/黑名单 登出后 token 立即失效 4 小时
安全中间件链 helmet + CORS + 限流 + zod + 错误处理 接口安全防护到位 3 小时
测试覆盖 Service 层单测 + 接口测试,覆盖率 > 70% CI 跑通 4 小时
可观测接入 pino + requestId + OTel 自动埋点 Jaeger 看到 trace 3 小时

七、排障表

现象 可能原因 排查步骤 解决办法
401 未授权 无 token 或 token 错 看 Authorization 头 前端带 token,后端校验
CORS 报错 没配白名单 看响应头 加 CORS 中间件
接口被刷 没限流 看 QPS 加 rate-limit
测试时过时过 依赖真实 DB 看测试配置 Mock DB
日志无上下文 console.log 看日志输出 用 pino child
内存持续涨 缓存无淘汰 拍堆快照 加 LRU/上限
SQL 注入 拼字符串 SQL 看 SQL 日志 用参数化
SSRF 打到内网 不校验 URL 看目标 host 加内网段黑名单

八、出口条件

全部勾选后再进入 阶段 7 全栈同构、部署与生产化。

  • [ ] 能用 JWT 做鉴权,说明与 Session 的取舍,能加黑名单登出
  • [ ] 能配 helmet、CORS、限流,防 SQL/NoSQL 注入、SSRF、原型污染
  • [ ] 能用 zod 校验参数,说明类型推断价值
  • [ ] 能用 Vitest 写单元测试,用 supertest 写接口测试,Mock 外部依赖
  • [ ] 能用 pino 输出结构化 JSON 日志,带 request id
  • [ ] 能接 OpenTelemetry,说明 trace id 跨服务传递
  • [ ] 能用 clinic doctor 或 --inspect 定位 CPU 与内存问题
  • [ ] 排障表八个现象,随机抽三个能在 5 分钟内给出排查路径

自测题:

  1. JWT 与 Session 怎么选?JWT 怎么主动登出?
    • 要点:无状态 vs 有状态;Redis 黑名单。
  2. helmet 主要防什么?
    • 要点:安全响应头,防点击劫持、MIME 嗅探、CSP 相关攻击。
  3. SSRF 是什么?怎么防?
    • 要点:服务器被诱导访问内网;URL 校验禁内网段。
  4. 为什么测试不能依赖真实数据库?
    • 要点:不稳定、数据污染、慢;Mock 或内存库。
  5. pino 为什么比 console.log 好?
    • 要点:结构化 JSON、级别、性能、可带上下文。
  6. 内存泄漏怎么定位?
    • 要点:堆快照对比,看谁在涨;常见全局数组、无界缓存。
  7. 原型链污染怎么产生?怎么防?
    • 要点:合并用户输入时 __proto__ 被写入;白名单字段或冻结。