07.5 阶段 4:Web 框架主线
所属:全栈开发面试题库 / 学习路径 / 07 Node.js 全栈
本页目录
一、阶段定位
前面四个阶段把语言、运行时、模块、TypeScript 都铺好了,但还没有"对外提供服务"。本阶段用 Express/Koa/Fastify 写 HTTP 服务,理解中间件模型,并以 NestJS 理解工程化分层。这是从"写脚本"到"写后端"的真正入口。
与前后阶段的衔接:往上接 阶段 3 TypeScript 工程化,NestJS 是重度 TS 框架,装饰器与 DI 建立在 TS 基础上。往下接 阶段 5 数据层、缓存与队列,路由里的 service 层要接 ORM 与 Redis;再往后接 阶段 6 鉴权、安全、测试与可观测,中间件会扩展到鉴权、限流、日志。
本阶段原有的四个卡点,展开成可判断的现象依据:
- Express 错误没有传到错误处理中间件。判断标准:路由里
throw new Error后服务崩掉或返回 HTML 错误页,没走你定义的(err, req, res, next) => {}。原因通常是异步回调里 throw,Express 4 不会自动捕获。 - Koa 中间件忘记 await next()。判断标准:中间件里
next()没写 await,下游中间件还没执行完就先写了 response,或顺序错乱。 - 把业务逻辑堆在控制器里,服务层无法复用与测试。判断标准:一个路由函数里几百行,直接操作数据库、调 Redis、拼业务,无法单测。
- 不理解 NestJS 的 DI 容器如何解析依赖。判断标准:写了
constructor(private userService: UserService),但忘了@Injectable()或模块没providers,启动报Nest can't resolve dependencies。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能用 Express 写一个带路由、中间件、错误处理的服务 | curl 打各个接口,错误走统一错误中间件 |
| 能用 Koa 写出洋葱模型,解释 next() 前后执行顺序 | 手写三个中间件,打印顺序 |
| 能用 Fastify 写带 schema 校验的接口 | 参数错误返回 400,schema 自动转 JSON |
| 能用 NestJS 写出 Controller/Service/Module 分层 | 启动后路由可访问,service 可被注入 |
| 能解释中间件链、洋葱模型、DI 容器三者关系 | 画请求从入口到响应的链路图 |
| 能处理 CORS、Cookie、静态资源 | 浏览器跨域请求成功,cookie 正确设置 |
建议学时:
- 全职(每天 4–6 小时):2 周,约 60 小时。Express 15 小时、Koa 10 小时、Fastify 10 小时、NestJS 20 小时、CORS/Cookie/静态 5 小时。
- 在职(每天 2 小时):5–6 周。NestJS 分层是面试重点,时间要给够。
学时分配建议:HTTP 与 Express 25%、Koa 洋葱 15%、Fastify 15%、NestJS 分层与 DI 30%、CORS/Cookie/会话 15%。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| HTTP 方法与状态码 | 知道 GET/POST、200/400/401/500 | 01.2 计算机网络 |
| Node 异步 | 能写 async/await | 07.1 阶段 0 |
| TypeScript 基础 | 能写接口与泛型 | 07.4 阶段 3 |
| npm 安装 | 会 npm install express |
07.3 阶段 2 |
| 命令行 curl | 能用 curl 测接口 | 07.1 阶段 0 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| HTTP | 方法、状态码、请求头、请求体 | 会用 | 06.1 通用后端工程 |
| Express | app.use、路由、错误中间件、next(err) |
能讲清原理 | 06.4 Node.js 后端 |
| Koa | 洋葱模型、ctx、await next() |
能讲清原理 | 06.4 Node.js 后端 |
| Fastify | schema 校验、register 插件、性能 |
会用 | 06.4 Node.js 后端 |
| NestJS | Module/Controller/Service、DI、Pipe、Guard、Interceptor | 能讲清原理 | 06.4 Node.js 后端 |
| CORS | 预检 OPTIONS、白名单、Credentials | 会用 | 06.1 通用后端工程 |
| Cookie 与会话 | Set-Cookie、HttpOnly、Session 基础 |
会用 | 06.1 通用后端工程 |
| 静态资源 | express.static、路径前缀 |
会用 | 06.4 Node.js 后端 |
进度管理建议:Express 与 Koa 必须到"能讲清原理",Fastify 与 NestJS 到"会用"并能讲分层。
五、分模块精讲
5.1 HTTP 基础与 Express 中间件
为什么需要它:Express 是 Node 最经典的 Web 框架,中间件模型是理解所有 Node 框架的基础。不理解 next(),就不知道请求为什么被拦下或放行。
核心机制:
- 中间件是一个函数
(req, res, next) => {},按注册顺序执行。 next()把控制权交给下一个中间件;不调next()也不res.end(),请求会挂起。app.use(fn)对所有路径生效;app.use("/api", fn)对/api前缀生效。- Express 4 不会自动捕获异步路由里 throw 的错误,必须
next(err)传。 - 请求体需要
express.json()中间件解析。
最小可运行示例:
const express = require("express");
const app = express();
app.use(express.json()); // 解析 JSON body
// 日志中间件:打印每个请求
app.use((req, res, next) => {
console.log(req.method, req.url);
next(); // 必须调,否则请求挂起
});
app.get("/hello", (req, res) => {
res.json({ message: "hi" });
});
// 错误处理中间件:四个参数
app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).json({ error: err.message });
});
app.listen(3000);
// 异步错误必须手动 next(err)
app.get("/user/:id", async (req, res, next) => {
try {
const user = await getUser(req.params.id);
res.json(user);
} catch (err) {
next(err); // Express 4 不会自动捕获
}
});
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 请求挂起不返回 | 中间件没调 next() 也没 res.end() | 补 next() 或 res.end() |
| JSON body 解析成 undefined | 没加 express.json() | app.use(express.json()) |
| 错误中间件没触发 | 异步 throw 没 next(err) | 用 try/catch + next(err) |
| 错误中间件收到 HTML 默认错误页 | 错误中间件签名不对(必须四个参数) | 写成 (err, req, res, next) |
面试考法:"Express 中间件执行顺序""Express 4 异步错误怎么处理"。答到按注册顺序、next 放行;异步必须 next(err)。
5.2 Koa 洋葱模型与 ctx
为什么需要它:Koa 把中间件组织成"洋葱"——请求从外到内,响应从内到外。每个中间件能同时处理请求与响应阶段,比 Express 的"只进不出"更灵活。
核心机制:
- Koa 中间件签名是
async (ctx, next) => {}。 await next()把控制权交给下游,下游全部执行完后回到当前中间件继续。- 执行顺序:外层 before → 内层 before → 内层 after → 外层 after。
ctx是上下文对象,封装了 request 与 response:ctx.request、ctx.response、ctx.body(设置响应体)、ctx.params。
最小可运行示例:
const Koa = require("koa");
const app = new Koa();
app.use(async (ctx, next) => {
console.log("1. 外层 before");
await next();
console.log("4. 外层 after");
});
app.use(async (ctx, next) => {
console.log("2. 内层 before");
await next();
console.log("3. 内层 after");
});
app.use(async (ctx) => {
ctx.body = { message: "hi" };
});
app.listen(3000);
// 输出顺序:1 → 2 → 3 → 4
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 中间件顺序错乱 | 忘了 await next() | 每个 next 前加 await |
| ctx.body 没生效 | 没设置 ctx.body | 用 ctx.body = ... |
| 异常没被外层捕获 | 没 try/catch | 外层中间件包 try/catch |
面试考法:"画一下 Koa 洋葱模型""与 Express 中间件区别"。答到双向控制、await next;Express 是单向 next。
5.3 Fastify schema 校验与插件
为什么需要它:Fastify 用 JSON Schema 自动校验请求/响应,性能比 Express 高,插件体系清晰。适合对性能与类型安全都有要求的项目。
核心机制:
- 路由配置里写
schema:body、querystring、params、response。 - 校验失败自动返回 400。
fastify.register(plugin, { prefix })注册插件,支持分组。- 性能:Fastify 内部用快速 JSON 序列化(fast-json-stringify),比 JSON.stringify 快。
最小可运行示例:
const fastify = require("fastify")({ logger: true });
fastify.post("/user", {
schema: {
body: {
type: "object",
required: ["name", "age"],
properties: {
name: { type: "string" },
age: { type: "number" }
}
}
}
}, async (req, reply) => {
return { created: req.body };
});
fastify.listen({ port: 3000 });
# 缺字段返回 400
curl -X POST localhost:3000/user -H "Content-Type: application/json" -d '{"name":"Ann"}'
# {"statusCode":400,...}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| schema 没生效 | 路由配置里没传 schema | 加 schema 字段 |
| querystring 数组解析错 | 配置不对 | 用 type: "array" 或 string 数组 |
| 插件 prefix 不生效 | register 顺序错 | 在 register 时传 prefix |
面试考法:"Fastify 比 Express 快在哪""schema 校验怎么做"。答到 JSON Schema + 快速序列化。
5.4 NestJS 分层、DI、管道/守卫/拦截器
为什么需要它:NestJS 把 Express/Koa 包成一个"带约定的分层框架":Controller 处理 HTTP,Service 写业务,Module 组织依赖。依赖注入让组件可替换、可测试。
核心机制:
- Module:
@Module({ controllers, providers, exports }),组织一个功能域。 - Controller:
@Controller("user"),处理路由,注入 Service。 - Service:
@Injectable(),业务逻辑,可被注入。 - DI 容器:启动时扫描所有
@Injectable(),构造函数里声明依赖自动实例化。 - Pipe:
@UsePipes(),在进入路由前转换/校验参数(类似 Fastify schema)。 - Guard:
@UseGuards(),鉴权,返回 true/false 决定是否放行。 - Interceptor:在路由前后加逻辑,类似 Koa 洋葱。
最小可运行示例:
// user.service.ts
import { Injectable } from "@nestjs/common";
@Injectable()
export class UserService {
private users = [{ id: 1, name: "Ann" }];
findAll() { return this.users; }
findOne(id: number) { return this.users.find(u => u.id === id); }
}
// user.controller.ts
import { Controller, Get, Param } from "@nestjs/common";
import { UserService } from "./user.service";
@Controller("user")
export class UserController {
constructor(private readonly userService: UserService) {}
@Get()
findAll() { return this.userService.findAll(); }
@Get(":id")
findOne(@Param("id") id: string) { return this.userService.findOne(+id); }
}
// user.module.ts
import { Module } from "@nestjs/common";
import { UserController } from "./user.controller";
import { UserService } from "./user.service";
@Module({
controllers: [UserController],
providers: [UserService]
})
export class UserModule {}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
Nest can't resolve dependencies of UserService |
忘了 @Injectable 或模块没 providers | 加 @Injectable,在 module providers 注册 |
| 跨模块 Service 注入不了 | 没 exports | 在 module exports 该 Service |
| 路由 404 | Controller 没在 module 注册 | 加到 controllers |
| Guard 不生效 | 忘了 @UseGuards | 加装饰器或全局注册 |
面试考法:"NestJS 分层""DI 容器怎么工作""Pipe 与 Guard 区别"。答到 Controller/Service/Module;DI 构造函数注入;Pipe 校验转换,Guard 放行拦截。
5.5 CORS、Cookie 与会话基础
为什么需要它:浏览器跨域请求、登录状态、安全 Cookie 是 Web 服务必备。不理解 CORS 预检,前端调后端一直被拦。
核心机制:
- CORS:服务端在响应头加
Access-Control-Allow-Origin,浏览器才放行。 - 预检请求:
OPTIONS方法,服务端要返回Access-Control-Allow-Methods、Allow-Headers。 - Cookie:
Set-Cookie响应头,HttpOnly让 JS 读不到(防 XSS),Secure只在 HTTPS 发,SameSite防 CSRF。 - Session:服务端存会话,前端靠 Cookie 带 session id。
最小可运行示例:
// Express CORS
app.use((req, res, next) => {
res.header("Access-Control-Allow-Origin", "http://localhost:5173");
res.header("Access-Control-Allow-Methods", "GET,POST,PUT,DELETE,OPTIONS");
res.header("Access-Control-Allow-Headers", "Content-Type,Authorization");
res.header("Access-Control-Allow-Credentials", "true");
if (req.method === "OPTIONS") return res.sendStatus(204);
next();
});
// 设置 HttpOnly Cookie
res.cookie("token", "abc", { httpOnly: true, secure: false, sameSite: "lax" });
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 浏览器报 CORS 错 | 没加 Allow-Origin | 加响应头 |
| Cookie 不发 | 没设 credentials | fetch 加 credentials: "include",后端 Allow-Credentials true |
| OPTIONS 返回 404 | 没处理预检 | 提前返回 204 |
面试考法:"CORS 预检是什么""HttpOnly Cookie 作用"。答到 OPTIONS 请求、安全策略。
5.6 静态资源与路由组织
为什么需要它:除了 API,还要托管前端构建产物、上传文件。路由分组让代码不堆在一个文件里。
核心机制:
express.static("public")托管静态目录。express.Router()创建子路由,挂载到前缀。- 路由分组:按功能拆文件,
app.use("/api/user", userRouter)。
最小可运行示例:
const express = require("express");
const app = express();
const userRouter = require("./routes/user");
app.use(express.static("public"));
app.use("/api/user", userRouter);
app.listen(3000);
// routes/user.js
const router = require("express").Router();
router.get("/", (req, res) => res.json([{ id: 1 }]));
router.get("/:id", (req, res) => res.json({ id: req.params.id }));
module.exports = router;
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 静态资源 404 | 路径不对 | 看 public 目录结构 |
| 路由 prefix 重复 | 挂载时写了两次 | 统一在 app.use 写前缀 |
面试考法:"怎么组织路由""静态资源怎么托管"。答到 Router 分组 + static。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| Express hello | 写一个 GET /hello 返回 JSON | curl 通,错误中间件生效 | 1 小时 |
| Koa 洋葱 | 写三个中间件打印顺序 | 输出 1→2→3→4 | 1 小时 |
| Fastify schema | 写一个 POST /user 带 body 校验 | 缺字段返回 400 | 1 小时 |
| NestJS 分层 | 用 Nest CLI 生成 user module/controller/service | 启动后 /user 可访问 | 2 小时 |
| CORS 配置 | 配跨域中间件,浏览器请求成功 | 无 CORS 报错 | 1 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 修异步错误 | 给定异步 throw 没 next(err) 的路由,修掉 | 错误走中间件 | 0.5 小时 |
| 修洋葱顺序 | 给定没 await next 的 Koa 中间件,修掉 | 顺序正确 | 0.5 小时 |
| 抽 Service 层 | 把 Controller 里几百行业务抽到 Service | Controller 只剩路由,Service 可单测 | 2 小时 |
| NestJS DI 修复 | 给定 Nest can't resolve dependencies 报错,修掉 | 启动成功 | 1 小时 |
| 加 Cookie | 给登录接口加 HttpOnly Cookie | 浏览器看不到 token,请求自动带 | 1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 单机 API 服务 | 用 Express 写一个带路由分组、错误处理、日志的服务 | 接口完整,错误统一 | 6 小时 |
| 三框架对比 | 用 Express/Koa/Fastify 各写一个 hello,对比中间件模型 | 能讲清取舍 | 3 小时 |
| NestJS 工程骨架 | 配 Module/Controller/Service/Guard/Pipe,接 Swagger | 启动后 swagger 可访问 | 5 小时 |
| 静态托管 | 托管前端 dist,配 SPA fallback | 刷新路由不 404 | 1 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 请求挂起不返回 | 中间件没 next 也没 res.end | 看中间件链 | 补 next() 或 res.end() |
| JSON body 是 undefined | 没加 express.json() | 看 app.use | 加 app.use(express.json()) |
| 异步错误崩进程 | Express 4 不捕获异步 throw | 看路由 try/catch | 加 next(err) |
| Koa 中间件顺序乱 | 没 await next() | 看每个 next | 加 await |
| 浏览器 CORS 报错 | 没加 Allow-Origin | 看响应头 | 加 CORS 中间件 |
| NestJS 启动报依赖解析失败 | 忘了 @Injectable 或没 providers | 看 Nest 报错栈 | 补装饰器与 module 注册 |
| Cookie 不发送 | 没设 credentials | 看 fetch 与后端配置 | fetch 加 include,后端 Allow-Credentials |
| 静态资源 404 | 路径不对 | 看 public 结构 | 修正 static 路径 |
八、出口条件
全部勾选后再进入 阶段 5 数据层、缓存与队列。
- [ ] 能用 Express 写带路由、中间件、错误处理的服务,异步错误走 next(err)
- [ ] 能画 Koa 洋葱模型,解释 await next() 前后顺序
- [ ] 能用 Fastify schema 校验请求体
- [ ] 能用 NestJS 写 Controller/Service/Module,理解 DI 如何注入
- [ ] 能配 CORS 与 HttpOnly Cookie,解释预检请求
- [ ] 能把业务逻辑抽到 Service 层,Controller 只做路由
- [ ] 能处理静态资源与 SPA fallback
- [ ] 排障表八个现象,随机抽三个能在 5 分钟内给出排查路径
自测题:
- Express 错误中间件为什么必须是四个参数?
- 要点:Express 靠参数个数识别错误中间件,三个参数是普通中间件。
- Koa 洋葱模型里,
await next()之前与之后代码分别在哪个阶段执行?- 要点:之前是请求阶段(外层到内层),之后是响应阶段(内层回到外层)。
- NestJS 里 Service 忘了加
@Injectable()会怎样?- 要点:DI 容器不知道它,启动报 Nest can't resolve dependencies。
- CORS 预检请求是什么方法?服务端要返回什么?
- 要点:OPTIONS,返回 Allow-Methods、Allow-Headers、Allow-Origin。
- Express 4 里异步路由 throw 为什么不会进错误中间件?
- 要点:Express 4 只捕获同步 throw,异步错误必须手动 next(err)。
- Fastify schema 校验失败自动返回什么状态码?
- 要点:400。
- HttpOnly Cookie 为什么能防 XSS?
- 要点:JS 读不到 HttpOnly Cookie,即使页面被注入脚本也拿不到 token。