Koa

背景与问题界定 中间件（Middleware）是 Node.js Web 框架最核心的架构模式。从 Express 的线性链式调用到 Koa 的洋葱模型（Onion Model），中间件的组织方式深刻影响着应用的执行流程、错误处理和扩展能力。许多开发者在日常使用中只是简单地调用 app.use(fn)，却没有深入理解中间件的执行顺序、异步模型和错误传播机制。由此导致的问题包括：静态文件中间件与路由中间件的顺序颠导致 404 错误；错误处理中间件未正确放置导致异常被吞没；在 Koa 中使用 async/await 但漏写 next 导致的执行链断裂。理解并设计一套健壮的中间件体系，是构建稳定 Node.js 服务的基础。 目标拆解与工程约束 中间件顺序决定了执行流程：请求处理链的顺序由中间件注册顺序决定，任何顺序错误都可能导致功能异常，必须提供清晰的顺序规范文档。 错误处理中间件必须为最后一个中间件：Express 中错误处理中间件有 4 个参数 (err, req, res, next)；Koa 中通过在 catch 中捕获，两者均要求错误处理在最后注册。 异步中间件的正确率处理：async 中间件函数中的未捕获异常必须通过框架的错误处理渠道传播，不应使用全局的 process.on('unhandledRejection') 兜底。 中间件的生命周期与资源清理：中间件可能分配的资源（数据库连接、文件句柄、计时器）应在中间件执行完毕或请求结束时释放，避免资源泄漏。 方案设计 Express 的中间件体系是线性的：请求按注册顺序依次通过每个中间件，遇到响应终止则停止传递。这种模型简单直观，但存在两个局限：一是无法在响应发出后执行后置逻辑（如记录响应时间）；二是错误处理只能通过跳到 4 参数的错误中间件来处理。 Koa 的洋葱模型通过 async/await 和 next 函数实现了双向的执行流程。请求从外层中间件进入，经过 await next() 到达内层中间件，响应从内层逐步返回到外层： // Koa 洋葱模型示意图 app.use(async (ctx, next) => { console.log('① 进入外层中间件') await next() console.log('⑥ 返回外层中间件 - 响应后置处理') }) app.use(async (ctx, next) => { console.log('② 进入中层中间件') await next() console.log('⑤ 返回中层中间件') }) app.use(async (ctx) => { console.log('③ 进入内层中间件（路由处理）') ctx.body = { message: 'Hello' } console.log('④ 返回内层中间件') }) // 输出顺序: ① ② ③ ④ ⑤ ⑥ 这种模型的优势在于：请求前和响应后的逻辑可以自然地写在 await next() 上下两侧。日志记录、性能计时、事务管理等功能只需要一个中间件即可覆盖请求全生命周期。 ...