07.7 阶段 6:鉴权、安全、测试与可观测
所属:全栈开发面试题库 / 学习路径 / 07 Node.js 全栈
本页目录
一、阶段定位
阶段 5 的服务已经能跑业务、存数据,但还"裸奔":谁都能调接口、参数没校验、出问题不知道怎么查。本阶段补齐四件事:鉴权(JWT/Session/OAuth2)、安全防护(helmet/CORS/限流/注入)、测试(Vitest/supertest)、可观测(日志/指标/链路/内存排查)。这是从"能跑"到"能上生产"的最后一道关。
与前后阶段的衔接:往上接 阶段 5 数据层、缓存与队列,鉴权中间件要校验 JWT、查 Redis 会话;往下接 阶段 7 全栈同构、部署与生产化,日志与指标要在容器里收集、健康检查要配套。
本阶段原有的四个卡点,展开成可判断的现象依据:
- 只防 SQL 注入忽略 NoSQL 注入、SSRF 与原型链污染。判断标准:用 Prisma 参数化查询防了 SQL 注入,但
req.body直接传给Object.assign或$where没做校验;或接口接收一个 URL 参数直接fetch(url)不校验目标。 - 测试依赖真实数据库导致用例不稳定。判断标准:跑测试时需要本地 MySQL/Redis,数据互相污染,时过时不过;或每个用例跑完不清理。
- 日志只 console.log 无上下文。判断标准:线上报错只看到
Error: xxx,没有 request id、没有 user id、没有时间戳,无法定位是哪次请求。 - 线上直接开调试工具长期挂着。判断标准:生产环境用
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 分钟内给出排查路径
自测题:
- JWT 与 Session 怎么选?JWT 怎么主动登出?
- 要点:无状态 vs 有状态;Redis 黑名单。
- helmet 主要防什么?
- 要点:安全响应头,防点击劫持、MIME 嗅探、CSP 相关攻击。
- SSRF 是什么?怎么防?
- 要点:服务器被诱导访问内网;URL 校验禁内网段。
- 为什么测试不能依赖真实数据库?
- 要点:不稳定、数据污染、慢;Mock 或内存库。
- pino 为什么比 console.log 好?
- 要点:结构化 JSON、级别、性能、可带上下文。
- 内存泄漏怎么定位?
- 要点:堆快照对比,看谁在涨;常见全局数组、无界缓存。
- 原型链污染怎么产生?怎么防?
- 要点:合并用户输入时
__proto__被写入;白名单字段或冻结。
- 要点:合并用户输入时