06.4.1.2 中间件与错误处理
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.4 Node.js 后端 / 06.4.1 Node 后端工程
本节要解决的问题
- 中间件链如何组织,鉴权、解析、日志、拦截按什么顺序挂载?
- 参数校验放哪一层,字段级错误如何返回?
- 业务异常、异步错误、未捕获 rejection 如何统一收口,错误响应如何不泄漏内部细节?
版本前提:Node.js 20 LTS / NestJS 10;框架钩子名称以对应版本文档为准。
06.4.1.2-001 中间件链的执行顺序如何决定?
一句话结论
按挂载顺序线性执行:先注册的中间件先进入前置逻辑;洋葱模型中响应再按逆序返回;鉴权、日志、解析 body 等横切关注点排在业务路由之前,收尾类逻辑放最外层。
概念解释
中间件职责是横切请求处理:日志计时、身份解析、参数解析、CORS 等。顺序错误会导致后续中间件拿不到 body 或身份信息,或鉴权晚于业务执行。
常见误区
express.json()晚于业务路由挂载:路由里读不到请求体。- 错误处理中间件放在普通中间件之前:错误无法被正确转发到收口处理器。
追问
- 错误处理中间件签名是什么?Express 错误中间件为
(err, req, res, next)四参,框架据此识别。 - 路由级中间件与全局中间件区别?全局作用于所有请求,路由级只作用于匹配路径。
06.4.1.2-002 如何做统一错误处理?
一句话结论
定义业务异常类型携带状态码与错误码,业务层抛错;最外层错误处理器捕获后映射为统一错误响应结构,记录日志与 traceId,不把堆栈、内部路径返回给客户端。
概念解释
错误收口在入口层:Controller/Service 不手写错误响应,抛领域异常由处理器转换。统一结构包含错误码、提示信息、字段错误明细与请求标识。
常见误区
- 每个 catch 各自拼响应格式:错误结构不一致,前端难以统一处理。
- 直接把
err.stack返回前端:泄漏框架路径、依赖版本与内部实现。
追问
- 4xx 与 5xx 如何区分?客户端错误用 4xx 并带可读提示;服务端异常用 5xx,日志记录完整堆栈。
- 错误处理器还能做什么?补充 traceId、计数错误指标、按异常类型上报告警。
06.4.1.2-003 参数校验放在哪一层?
一句话结论
入口 DTO 层做格式校验(类型、长度、必填、正则),业务规则在 Service 层校验;框架 Pipe/校验库在进入控制器前拦截非法入参,业务不变量在事务内判定。
概念解释
格式校验回答"结构对不对",业务校验回答"规则允不允许"。两者分层:入口拦截畸形请求,Service 保证领域状态合法。
常见误区
- 把业务唯一性、余额约束写进 Schema:Schema 无法表达跨表业务规则。
- 跳过 DTO 直接读
req.body字段散落:校验遗漏、类型不可控。
追问
- 常用校验库有哪些?class-validator + class-transformer(NestJS 常用)、zod、Joi,按项目栈选择。
- 校验失败在哪里返回?入口校验器统一返回 400 与字段错误数组。
06.4.1.2-004 如何返回字段级校验错误?
一句话结论
校验结果按字段聚合为 field -> message[] 数组,响应体携带错误字段名与可读提示;HTTP 状态码用 400,错误码标识校验失败,前端可定位到具体输入项。
概念解释
字段级错误把校验失败从一句笼统提示展开到输入项:每个非法字段对应一条可读消息,前端可绑定到对应表单项。错误结构与业务错误复用同一 envelope,用错误码区分类型。
示例
{
"code": "VALIDATION_FAILED",
"message": "参数校验失败",
"errors": [
{ "field": "email", "message": "邮箱格式不正确" },
{ "field": "age", "message": "年龄必须大于 0" }
]
}
常见误区
- 只返回一句"参数错误":调用方不知道哪个字段、怎么改。
- 错误字段名暴露内部变量约定:按 API 契约字段名返回,不泄漏数据库列名。
追问
- 嵌套对象错误如何表达?按路径标注字段(如
items.0.sku)。 - 校验错误与业务错误结构分开?可复用同一错误结构,用错误码区分类型。
06.4.1.2-005 异步错误如何被捕获?
一句话结论
async 路由/中间件内的同步抛出会被框架识别;未 await 的 Promise rejection 不会自动进入错误链,必须 await 捕获或包一层错误包装器;进程级兜底监听未处理 rejection。
概念解释
Express 传统中间件需要 next(err) 传递错误,异步函数错误要手动捕获再 next;NestJS 等框架对 async 处理器做了包装。忘记等待的异步任务是最常见的漏网错误源。
常见误区
- fire-and-forget 调用不捕获错误:后台 rejection 无人处理,触发进程告警。
- async 中间件不包错误处理:异常挂起连接,请求超时无响应。
追问
- 未处理 rejection 有什么进程级影响?Node 默认行为可能退出进程(版本行为以官方文档为准),必须显式兜底。
- 后台任务错误怎么记录?独立 try/catch,写日志与指标,必要时重试或告警。
06.4.1.2-006 日志与 traceId 如何贯穿请求?
一句话结论
入口中间件生成或解析 TraceId 放入请求上下文,日志输出统一携带 TraceId、服务名、实例、级别与耗时;异步链路通过上下文传递,日志平台按 TraceId 串起一次请求的全部记录。
概念解释
Node 上下文可用 AsyncLocalStorage 保存请求级信息,避免逐层透传参数。日志字段结构化,便于检索聚合;敏感信息在日志出口脱敏。
常见误区
- 日志只打文本消息:无法按链路、服务、实例检索。
- 异步线程/任务丢失上下文:后台日志挂不上原请求 TraceId。
追问
- AsyncLocalStorage 解决什么问题?在异步调用链中共享请求级上下文,不依赖函数参数传递。
- 日志级别怎么管?生产默认 INFO,异常链路临时 DEBUG,避免大日志量拖垮磁盘。
06.4.1.2-007 请求体解析与编码注意什么?
一句话结论
入口挂载 JSON/表单解析器,限制 body 大小与编码类型;解析失败按 400 处理;文件上传走专用解析与大小限制,避免与普通 JSON body 混在一个中间件。
概念解释
body 解析在路由之前完成,解析器负责把原始流转为对象并处理大小限制。无限制的 body 是内存攻击入口。
常见误区
- 不设 body 大小上限:超大请求撑爆内存。
- 解析器对未知 Content-Type 放行:畸形请求进入业务层后报错不清晰。
追问
- 表单与 JSON 如何区分?按 Content-Type 选择对应解析器,拒绝不支持的类型。
- 大文件上传怎么处理?流式接收、限制大小与类型,落盘前校验。
06.4.1.2-008 CORS 如何配置?
一句话结论
按白名单放行来源、方法与 Header;生产环境不要用通配 * 配合凭证;预检 OPTIONS 请求由 CORS 中间件直接响应,不进入业务路由。
概念解释
跨域策略由浏览器强制执行,服务端返回 CORS 头告知是否允许。携带 Cookie/凭证时来源必须明确列出,不能用通配符。
常见误区
- 全开放
Access-Control-Allow-Origin: *:内部接口也被任意站点跨域访问。 - 忽略预检缓存:OPTIONS 每次打业务路由,增加无谓开销。
追问
- 凭证与通配符为何冲突?规范禁止通配来源同时允许凭证,浏览器会拦截。
- 动态来源怎么校验?对照白名单回显匹配的 Origin,不直接回显任意请求来源。
06.4.1.2-009 未匹配路由的 404 如何处理?
一句话结论
所有业务路由之后挂载兜底中间件,未匹配请求返回统一 404 响应结构;静态资源与 API 路径分开判定,避免把未知接口误当静态文件处理。
概念解释
404 兜底是错误链的一部分:未命中任何路由时不落到默认错误页,返回与 API 一致的 JSON 错误结构。
常见误区
- 框架默认 HTML 404 直接返回:JSON 接口拿到非约定格式。
- 兜底中间件挂在路由之前:所有请求都被 404 拦截。
追问
- 404 与 405 区别?路径存在但方法不匹配返回 405,路径不存在返回 404。
- 未知接口要不要记日志?可低频记录扫描行为,不影响正常请求。
06.4.1.2-010 鉴权中间件应挂在什么位置?
一句话结论
鉴权排在日志、解析之后,业务路由之前;受保护路由通过路由级中间件/守卫挂载,公开路径显式放行;解析出的身份写入请求上下文供下游使用。
概念解释
鉴权前置拦截未认证请求,避免业务层重复判断。身份对象(用户 ID、角色、租户)由鉴权中间件填充,下游只读取上下文。
常见误区
- 业务控制器里逐个查登录状态:鉴权逻辑散落,遗漏即越权。
- 鉴权之后才解析 body:受保护接口仍可能被未认证请求消耗解析资源。
追问
- 路由级与全局鉴权怎么取舍?全局默认拒绝,公开接口显式放行更安全。
- 身份信息如何向下游传递?上下文对象,不依赖请求头外部传入的用户标识。
06.4.1.2-011 NestJS 的 Guard、Interceptor、Pipe 分别在什么阶段执行?
一句话结论
Pipe 在入参到达控制器前做校验与转换;Guard 判定是否允许进入;Interceptor 在控制器前后包裹执行,做响应改写、计时、日志;异常过滤器统一收口错误。
概念解释
NestJS 把横切职责拆成不同生命周期单元:Pipe 管数据,Guard 管准入,Interceptor 管前后处理,Filter 管错误。组合顺序为 Guard → Pipe → Controller → Interceptor → Filter。
常见误区
- 把校验写进 Interceptor:职责错位,Pipe 才是入参转换校验位置。
- Interceptor 里做权限判定:准入应归 Guard。
追问
- Interceptor 能改响应吗?能,在控制器返回后统一包装响应结构。
- 全局与控制器级如何选择?横切能力全局注册,局部行为挂控制器/方法。
06.4.1.2-012 业务异常类型如何设计?
一句话结论
按错误语义分层定义异常基类:参数错误、未认证、无权限、资源不存在、冲突、下游依赖失败、内部错误;每类绑定默认 HTTP 状态码与错误码,业务代码抛对应子类。
概念解释
异常类型表达错误原因,错误处理器按类型映射 HTTP 状态与响应。业务层不关心最终 HTTP 格式,只声明失败语义。
常见误区
- 全部抛
Error字符串:处理器无法区分 4xx/5xx,也无法按类型处理。 - 异常携带内部 SQL/堆栈信息:泄漏到响应与日志级别不清。
追问
- 下游调用失败怎么归类?依赖异常包装为内部错误或降级业务错误,保留原始 cause 供日志排查。
- 错误码怎么规划?按域分段,前端按码分支处理,提示文案可本地化。
06.4.1.2-013 进程级异常兜底需要监听什么?
一句话结论
监听 uncaughtException 与 unhandledRejection,记录现场日志后按策略退出并交由进程管理器重启;不能在未处理异常后继续假设进程状态一致。
概念解释
未捕获异常可能使进程处于不一致状态,进程管理器(PM2/K8s)负责拉起新实例。兜底监听只做记录与安全退出,不尝试无限恢复。
常见误区
- 捕获未处理异常后继续运行:内存状态可能已损坏,后续行为不可预测。
- 只在业务代码 catch:漏网的异步回调仍会打到进程级事件。
追问
- 退出前要做什么?停止接收新请求、处理完在途任务、上报错误后退出。
- 进程由谁重启?PM2/容器编排负责,应用本身不做守护进程。
06.4.1.2-014 响应结构如何统一封装?
一句话结论
成功响应统一包裹为 { data, code, message, traceId } 或按约定直接返回资源;失败走统一错误结构;列表响应附带分页元信息;序列化在拦截器/响应层完成,业务层只返回数据。
概念解释
响应约定让前端解析逻辑统一。包装层负责加 traceId、时间戳等横切字段,控制器不重复拼接 envelope。
常见误区
- 不同接口成功/失败结构不一致:前端需要逐接口适配。
- 响应里带 ORM 内部字段或关联对象全部序列化:字段冗余且可能泄漏。
追问
- 分页元信息放哪里?
{ list, total, page, pageSize }与数据并列。 - 二进制/文件响应如何绕过包装?专用路由直接返回流,不经过 JSON 包装层。
06.4.1.2-015 请求超时如何处理?
一句话结论
为下游调用设置连接/读超时;入口服务配置请求超时上限,超时后主动返回 504/408 并释放资源;慢请求记录指标,避免连接与线程长期占用。
概念解释
超时是故障隔离的一部分:下游变慢不能无限等待。入口超时与下游超时分层配置,总预算不超过入口上限。
常见误区
- 不设下游超时:连接挂在慢依赖上,资源被耗尽。
- 超时后不中断在途任务:已释放响应但后台仍占用连接与内存。
追问
- 超时响应要不要重试?仅幂等读请求可有限重试,写接口不自动重试。
- 超时指标看什么?P99 耗时与超时率,结合下游依赖定位慢跳。
06.4.1.2-016 中间件如何做到可复用与可测试?
一句话结论
横切逻辑写成独立函数/类,输入只依赖请求响应上下文与配置,不内嵌业务分支;单元测试直接调用中间件,模拟请求上下文断言放行、拒绝与下游调用。
概念解释
可复用中间件保持职责单一:鉴权、日志、解析各自独立,通过组合挂载。业务特有的分支应下沉到 Service。
常见误区
- 中间件里判断具体业务资源权限:变成业务代码无法复用。
- 测试依赖真实 HTTP 服务器:启动慢、断言范围大,应直接测中间件函数。
追问
- 配置如何注入?工厂函数接收配置返回中间件实例,适配不同环境。
- 中间件间共享什么?请求上下文对象,不依赖全局可变变量。
06.4.1.2-017 错误响应如何避免泄漏内部细节?
一句话结论
对外响应只含错误码、提示文案与字段错误;堆栈、框架版本、文件路径、SQL、内部主机名只进服务端日志;5xx 返回通用提示,详细原因由 TraceId 关联内部排查。
概念解释
错误细节是攻击信息源:泄漏路径与依赖版本便于攻击者定向利用。分层输出:客户端可读提示,服务端完整现场。
常见误区
- 开发环境习惯把堆栈返回前端,生产忘记关闭:细节随上线泄漏。
- 错误消息拼接内部异常原文:数据库约束、表名暴露给调用方。
追问
- 如何验证不泄漏?巡检错误响应样例,异常测试覆盖 4xx/5xx 分支。
- 客户端如何拿到排查线索?响应带 traceId,与服务端日志对应。
06.4.1.2-018 日志、错误与监控指标如何衔接?
一句话结论
错误处理器在收口处计数错误指标(按错误码/路由),记录带 TraceId 的日志;指标驱动告警,日志与链路追踪提供现场;三者用同一请求标识关联,形成可观测闭环。
概念解释
错误处理不只是返回响应:每个失败入口都应产生可观测信号。指标看趋势与量级,日志看细节,追踪看链路位置。
常见误区
- 只记日志不报指标:错误率趋势无人感知,告警无法建立。
- 指标标签无限维度:按路由/错误码聚合,不拼用户 ID 等高基数字段。
追问
- 哪些错误要告警?5xx、下游依赖失败、鉴权异常突增;4xx 通常只做趋势观察。
- 错误日志级别怎么分?业务可预期失败记 WARN,内部异常记 ERROR 并附堆栈。