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

07.5 阶段 4:Web 框架主线

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

本页目录

一、阶段定位

前面四个阶段把语言、运行时、模块、TypeScript 都铺好了,但还没有"对外提供服务"。本阶段用 Express/Koa/Fastify 写 HTTP 服务,理解中间件模型,并以 NestJS 理解工程化分层。这是从"写脚本"到"写后端"的真正入口。

与前后阶段的衔接:往上接 阶段 3 TypeScript 工程化,NestJS 是重度 TS 框架,装饰器与 DI 建立在 TS 基础上。往下接 阶段 5 数据层、缓存与队列,路由里的 service 层要接 ORM 与 Redis;再往后接 阶段 6 鉴权、安全、测试与可观测,中间件会扩展到鉴权、限流、日志。

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

  1. Express 错误没有传到错误处理中间件。判断标准:路由里 throw new Error 后服务崩掉或返回 HTML 错误页,没走你定义的 (err, req, res, next) => {}。原因通常是异步回调里 throw,Express 4 不会自动捕获。
  2. Koa 中间件忘记 await next()。判断标准:中间件里 next() 没写 await,下游中间件还没执行完就先写了 response,或顺序错乱。
  3. 把业务逻辑堆在控制器里,服务层无法复用与测试。判断标准:一个路由函数里几百行,直接操作数据库、调 Redis、拼业务,无法单测。
  4. 不理解 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 分钟内给出排查路径

自测题:

  1. Express 错误中间件为什么必须是四个参数?
    • 要点:Express 靠参数个数识别错误中间件,三个参数是普通中间件。
  2. Koa 洋葱模型里,await next() 之前与之后代码分别在哪个阶段执行?
    • 要点:之前是请求阶段(外层到内层),之后是响应阶段(内层回到外层)。
  3. NestJS 里 Service 忘了加 @Injectable() 会怎样?
    • 要点:DI 容器不知道它,启动报 Nest can't resolve dependencies。
  4. CORS 预检请求是什么方法?服务端要返回什么?
    • 要点:OPTIONS,返回 Allow-Methods、Allow-Headers、Allow-Origin。
  5. Express 4 里异步路由 throw 为什么不会进错误中间件?
    • 要点:Express 4 只捕获同步 throw,异步错误必须手动 next(err)。
  6. Fastify schema 校验失败自动返回什么状态码?
    • 要点:400。
  7. HttpOnly Cookie 为什么能防 XSS?
    • 要点:JS 读不到 HttpOnly Cookie,即使页面被注入脚本也拿不到 token。