06.4.1.1 框架选型与分层架构
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.4 Node.js 后端 / 06.4.1 Node 后端工程
本节要解决的问题
- Express、Koa、Fastify、NestJS 各自定位与选型边界是什么?
- 一个 Node 后端如何按 Controller / Service / Repository 分层,模块与依赖如何组织?
- Node 异步模型、单线程约束与目录结构对架构有什么影响?
版本前提:Node.js 20 LTS / NestJS 10;框架小版本行为以官方文档为准。
06.4.1.1-001 Express、Koa、Fastify、NestJS 怎么选?
一句话结论
Express 轻量灵活、生态最成熟,适合小服务与快速原型;Koa 基于 async 中间件、洋葱模型简洁;Fastify 内置 Schema 校验、性能更好;NestJS 模块化 + 依赖注入 + 装饰器,结构接近 Spring,适合大型团队长期维护。
对比
| 框架 | 定位 | 优势 | 适用 |
|---|---|---|---|
| Express | 最基础 Web 框架 | 生态大、上手快 | 中小服务、脚本式接口 |
| Koa | Express 同厂精简版 | async 洋葱模型 | 偏好简洁中间件链路 |
| Fastify | 高性能框架 | Schema 校验、低开销 | 高吞吐 API |
| NestJS | 企业级框架 | DI、模块体系、TypeScript 一等公民 | 大型工程、多团队协作 |
常见误区
- 小服务也上 NestJS:模块、装饰器、DI 带来额外结构成本。
- 只看基准测试选框架:生态成熟度、团队习惯与可维护性同样关键。
追问
- NestJS 的模块/控制器/服务怎么分层?Module 组织边界,Controller 处理请求,Service 承载业务,Repository 封装数据访问。
- Express 如何做分层?Router 按模块拆分,Controller 编排,Service 写业务,Repository 封装数据。
06.4.1.1-002 Node 处理请求的事件循环模型是怎样的?
一句话结论
Node 单线程跑 JavaScript 代码,事件循环把网络 IO、文件 IO、定时器等交给底层 libuv 线程池处理,完成后回调排入队列在主线程执行;阻塞主线程的同步计算会让所有请求排队。
概念解释
事件循环分阶段执行 timers、pending callbacks、poll、check、close callbacks 等;异步非阻塞 IO 不占主线程。JS 层只有一个执行线程,CPU 密集任务或同步重计算会阻塞循环。
常见误区
- 以为 Node 是多线程并发处理请求:JS 代码单线程,并发靠事件驱动与底层 IO 线程池。
- 把大循环、同步读文件写进请求处理:阻塞事件循环,吞吐骤降。
追问
- 为什么高并发下 Node 仍能扛住?IO 等待期间主线程可处理其他请求,非阻塞回调驱动。
- CPU 密集任务怎么处理?拆到 Worker 线程或独立进程,主进程只做编排。
06.4.1.1-003 Express 应用结构与中间件如何挂载?
一句话结论
express() 创建应用实例,app.use 挂载全局中间件,app.router 或 Router 按路径组织路由;请求按挂载顺序经过中间件链,匹配路由后进入处理函数。
概念解释
应用实例是中间件与路由的挂载容器:全局中间件作用于所有请求,Router 把某前缀下的路由与局部中间件收拢成独立模块。请求沿挂载顺序穿行,匹配到路由后交处理函数。
示例
const express = require('express');
const app = express();
app.use(express.json());
app.use('/users', require('./routes/users'));
app.listen(3000);
常见误区
- 中间件挂载顺序随意:鉴权、日志、解析 JSON 的先后会影响能否拿到 body 与身份。
- 所有路由写在一个入口文件:模块膨胀,无法按业务拆分维护。
追问
- Router 的作用是什么?把路由按业务域拆分到独立文件,再挂载到主应用。
- 静态资源与 API 路径如何区分?用不同前缀与中间件链分开挂载。
06.4.1.1-004 Koa 的洋葱模型是什么?
一句话结论
Koa 中间件按嵌套洋葱结构执行:请求从上到下穿过每层中间件,响应再从下到上原路返回;await next() 之前是前置逻辑,之后是后置逻辑,天然支持包裹与计时。
原理流程
请求 → 中间件A前置 → 中间件B前置 → 路由处理
← 中间件B后置 ← 中间件A后置 ← 响应
常见误区
- 忘记
await next():后续中间件与路由不执行,请求挂起。 - 在
next()之后读取请求 body:body 可能已被下游消费或重写。
追问
- 洋葱模型相比 Express 链式有什么优势?后置逻辑集中在同层,便于统一计时、收尾与错误包裹。
- Koa 错误怎么处理?最外层中间件 try/catch 包裹
await next(),统一生成错误响应。
06.4.1.1-005 Fastify 的核心特点是什么?
一句话结论
Fastify 以低开销与 Schema 驱动为核心:路由可配 JSON Schema 做入参校验与序列化,内置 JSON 解析与钩子体系;性能与类型化校验优于传统 Express 写法。
概念解释
Schema 既校验请求体/查询参数,也约束响应序列化结构;钩子(hook)对应中间件职责,生命周期更细。插件体系按封装能力扩展。
常见误区
- 把 Express 中间件直接搬到 Fastify:部分基于 Express 请求/响应对象的中间件不兼容。
- 只依赖 Schema 校验业务规则:Schema 管格式,业务不变量仍在 Service 层。
追问
- Schema 校验失败返回什么?Fastify 按校验错误返回 400 与字段错误明细。
- Fastify 与 NestJS 能结合吗?NestJS 可切换底层 HTTP 适配器为 Fastify(以版本支持为准)。
06.4.1.1-006 NestJS 的模块结构是怎样的?
一句话结论
NestJS 以 Module 为边界组织功能:@Module 声明控制器、服务、提供者与导出关系;Controller 接收请求,Service 承载业务,Provider 通过构造器注入;模块可导入导出形成依赖图。
概念解释
模块是 NestJS 的组织单元:内部 Provider 默认可见,需要跨模块复用的必须显式导出。控制器与服务在模块内配对,模块间通过导出的服务接口协作,形成可追溯的依赖图。
示例
@Module({
controllers: [UserController],
providers: [UserService],
exports: [UserService],
})
export class UserModule {}
常见误区
- 所有服务放一个全局模块:边界不清,循环依赖与隐式耦合增多。
- 控制器里写业务逻辑:跳过 Service 层,复用与测试困难。
追问
- 模块导出的意义?允许其他模块注入本模块导出的 Provider,未导出的内部服务不可见。
- 共享能力放哪里?抽取公共模块,被业务模块导入。
06.4.1.1-007 NestJS 依赖注入如何工作?
一句话结论
框架在启动时扫描 Provider 元数据,按类型/标识构造依赖图,实例化并注入到消费方构造器;作用域控制实例生命周期,模块解耦同时便于替换与测试。
概念解释
DI 容器负责创建与持有对象,业务类声明依赖而非自己 new。构造器参数类型结合装饰器元数据决定注入什么;测试时可用替身 Provider 覆盖。
常见误区
- 手动
newService:绕过容器,无法替换实例,也拿不到其他注入依赖。 - 循环依赖:模块与 Provider 互相注入,需拆职责或用前向引用,应优先消除。
追问
- 单例与请求作用域区别?默认 Provider 全局单例;请求作用域每请求新建,避免状态跨请求污染。
- 如何在测试中替换依赖?注册测试用 Provider 覆盖原实现。
06.4.1.1-008 后端分层中 Controller、Service、Repository 各管什么?
一句话结论
Controller 只做请求解析、参数校验调用与响应组装;Service 承载业务规则与事务编排;Repository 封装数据访问,向上返回领域对象,不暴露 SQL/ORM 细节。
对比
| 层 | 职责 | 不该做 |
|---|---|---|
| Controller | 路由、入参出参、状态码 | 业务规则、直接拼 SQL |
| Service | 业务流程、事务、调用编排 | 处理 HTTP 细节 |
| Repository | 持久化读写、查询封装 | 跨表业务编排 |
常见误区
- Controller 直接调 Repository 写业务:分层被绕过,规则散落在入口。
- Repository 返回 ORM 模型给 Controller:持久化细节泄漏到表现层。
追问
- DTO 与领域对象区别?DTO 是接口出入参结构,领域对象表达业务状态,两者按需转换。
- 跨服务调用放哪层?Service 层编排,外部客户端封装在独立模块。
06.4.1.1-009 项目目录如何按模块组织?
一句话结论
按业务域拆模块目录,每模块内分 controller / service / repository / dto / entity;公共能力抽 shared 或 common 模块;配置、入口、基础设施单独放置,避免按技术类型把全项目文件摊平。
概念解释
目录结构反映模块边界:新功能加入对应业务目录,公共复用进 common。平铺按文件类型组织在项目变大后难以定位与拆分。
常见误区
- 所有 controller 放一个文件夹、所有 service 放另一个:业务边界被目录切碎。
- common 目录变成杂物间:无归属的工具代码持续堆积。
追问
- 模块间能否直接引用对方 Repository?应通过导出的 Service 或接口,避免数据层耦合。
- 第三方客户端放哪里?基础设施模块封装,Service 依赖抽象接口。
06.4.1.1-010 回调、Promise 与 async/await 如何演进?
一句话结论
异步代码从回调嵌套(回调地狱)演进到 Promise 链式调用,再到 async/await 同步风格写法;错误用 try/catch 或 .catch 捕获,异步结果必须显式等待,不能当同步值用。
概念解释
JavaScript 异步操作不阻塞主线程,结果通过回调、Promise 或 await 在后续轮次返回。async 函数返回 Promise,未等待的调用不会阻塞当前代码,错误以 rejection 形式传递。
示例
async function getUser(id: number) {
const user = await userRepo.findById(id);
if (!user) throw new NotFoundError();
return user;
}
常见误区
await写在循环里串行了:无依赖的查询应Promise.all并行。- 异步函数不捕获错误:rejection 冒泡成未处理异常,进程可能退出。
追问
Promise.all与Promise.allSettled区别?前者任一失败即失败;后者等全部完成并收集各自结果。- 并行上限怎么控制?批量任务用池化限流,避免一次性打满下游与连接。
06.4.1.1-011 Node 单线程如何利用多核?
一句话结论
单进程只占一个 CPU 核;通过 Cluster 或 Worker 进程/fork 起多实例绑定同一端口,由负载均衡或进程管理器分发请求;主进程负责调度与监控,工作进程执行业务。
概念解释
多核利用靠多进程而非 JS 线程内并行。每个工作进程独立事件循环与内存,状态不共享,需通过消息或外部存储同步。
常见误区
- 单进程部署在多核机器上:闲置其余核心,吞吐受限。
- 进程间共享内存变量:各进程内存隔离,变量不互通。
追问
- PM2/Cluster 区别?PM2 是进程管理工具,Cluster 是 Node 内置多进程能力,二者可配合。
- 多进程下会话怎么办?Session 存外部存储(Redis),进程无状态。
06.4.1.1-012 路由如何按模块拆分与命名?
一句话结论
路由按业务域拆分到独立 Router/Controller 文件,路径用名词复数表达资源;HTTP 方法对应动作;路由前缀与模块目录一致,便于从路径定位代码。
概念解释
路由是入口层的模块边界:路径结构反映资源划分,参数与查询绑定到 DTO。集中路由表只做挂载,具体定义在各模块内。
常见误区
- 路径用动词 RPC 式命名:
/getUserList,破坏 REST 资源语义。 - 路由文件里写业务查询:应下沉到 Service。
追问
- 版本号放哪里?可放路径前缀、Header 或媒体类型,团队约定统一。
- 路由冲突如何排查?按注册顺序匹配,静态路径优先于参数路径。
06.4.1.1-013 DTO 与领域模型如何分层转换?
一句话结论
入口用 DTO 约束接口出入参结构并做格式校验;领域模型表达业务状态与规则;二者在 Controller/Service 边界转换,领域对象不直接暴露为接口响应。
概念解释
DTO 随 API 契约演进,领域模型随业务规则演进,解耦后接口字段调整不牵动内部模型。TypeScript 下可用接口/类分别定义,转换逻辑集中在映射层。
常见误区
- 直接把数据库实体返回前端:内部字段、敏感列与关联结构泄漏。
- 领域对象被 DTO 注解绑架:业务模型迁就接口结构。
追问
- 校验注解写在哪?DTO 层(class-validator/zod/Joi),业务不变量在 Service。
- 响应裁剪怎么做?映射到独立响应 DTO,只暴露允许字段。
06.4.1.1-014 配置如何加载与按环境隔离?
一句话结论
配置按环境分层:默认值 → 配置文件 → 环境变量 → 启动参数;敏感项只走环境变量或密钥服务,不进代码库;启动时校验必填配置,缺失快速失败。
概念解释
配置外部化让同一镜像在不同环境运行。环境变量适配容器与 CI,文件承载非敏感默认值;配置读取集中在配置模块,散落在代码里 process.env 难以管理。
常见误区
- 把生产密钥提交到仓库:泄漏后需全部轮换。
- 配置缺失静默用 undefined:运行到中途才报错,应启动期校验。
追问
- 多环境配置怎么组织?dev/test/prod 对应环境变量与配置文件,按 NODE_ENV 选择。
- 配置类型如何保证?用校验库解析为结构化对象,字段带类型与默认值。
06.4.1.1-015 接口文档(OpenAPI/Swagger)如何集成?
一句话结论
通过装饰器或 Schema 自动生成 OpenAPI 描述,覆盖路径、参数、请求响应结构与错误码;文档随代码维护,接口变更同步反映到文档,避免手写文档过时。
概念解释
NestJS 可用 Swagger 模块从装饰器元数据生成;Express/Fastify 可基于 JSDoc/Schema 产出 OpenAPI。文档与校验 Schema 可复用同一套结构定义。
常见误区
- 文档手写与代码两套:接口改了文档没改,联调按错误文档对接。
- 只记录成功响应:错误码与字段缺失,调用方无法处理失败场景。
追问
- 文档放哪个环境暴露?生产可关闭只读文档或加鉴权。
- 契约优先如何落地?先定 OpenAPI 再生成类型与校验,反向校验实现符合契约。
06.4.1.1-016 框架选型时如何评估长期维护?
一句话结论
看发布活跃度、版本兼容策略、生态包质量、团队既有经验与招聘可得性;锁定 Node LTS 与框架主版本,评估升级成本与安全补丁节奏,不只看初始开发速度。
概念解释
框架是长期依赖:停更框架会累积安全与兼容风险。选型把社区活跃度、 breaking change 频率、遗留项目迁移难度纳入评估。
常见误区
- 选博客推荐的新潮框架:生态薄、问题难查,遇到坑要自填。
- 忽略团队 TypeScript 能力:NestJS 项目类型体系薄弱会抵消框架收益。
追问
- 如何跟踪版本风险?关注 Release Notes、废弃特性清单与安全公告。
- 混合栈可以吗?入口框架统一,内部能力按模块封装,避免同一项目多套风格。
06.4.1.1-017 Node 模块化单体与微服务如何划边界?
一句话结论
初期按模块化单体组织代码,模块间经接口通信;当模块需要独立发布、独立扩容或异构技术栈时再拆服务;边界先在代码层清晰,拆分才有依据。
概念解释
微服务拆分的前置条件是模块边界稳定。单体阶段通过目录、接口与依赖约束模拟服务边界,避免数据库表与内部对象互相穿透。
常见误区
- 项目刚起步就拆微服务:分布式事务、链路与运维成本提前背上。
- 模块间直连共享表:拆服务时数据纠缠,无法独立演进。
追问
- 拆服务先拆哪个模块?边界清晰、变更独立、扩容需求明确的模块。
- 模块化单体如何限制耦合?模块只暴露接口,禁止跨模块直接引用内部实现。
06.4.1.1-018 什么时候该把 Express 项目迁到 NestJS?
一句话结论
当项目规模扩大、团队多人协作、需要统一分层/校验/DI/规范,且现有 Express 结构难以约束时再迁;迁移可按模块渐进进行,先在新模块用 NestJS 骨架,不要求一次性重写。
概念解释
迁移动力主要是结构治理与团队协作,而非性能。Express 到 NestJS 的差距是组织方式:DI、模块边界、装饰器元数据带来约束与可测试性。
常见误区
- 因为"NestJS 更高级"就全量重写:业务回归风险大,收益不明确。
- 迁移时连数据库访问层一起换:应保持数据访问稳定,先重构请求与业务层结构。
追问
- 渐进迁移怎么落地?入口先兼容两套路由,新模块按 NestJS 结构写,旧模块逐个收拢。
- 迁移前要补什么?测试覆盖、接口契约与目录边界,否则重构无安全网。