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

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 覆盖。

常见误区

  • 手动 new Service:绕过容器,无法替换实例,也拿不到其他注入依赖。
  • 循环依赖:模块与 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 结构写,旧模块逐个收拢。
  • 迁移前要补什么?测试覆盖、接口契约与目录边界,否则重构无安全网。