文章目录KoaNode.js 的轻量中间件框架KoaNode.js 的轻量中间件框架Koa 是由 Express 原班团队打造的 Node.js Web 框架目前在 GitHub 上有 35,713 个 Star。Koa 的核心设计思路是中间件栈。请求从上往下流过各个中间件响应再从下往上返回每个中间件都能在上下游之间做处理。这种机制让请求和响应的控制变得清晰。和 Express 相比Koa 的代码量很小核心只有大约 570 行。它只集成了少数几乎所有 HTTP 服务器都需要的功能比如内容协商、请求重定向、Node 原生对象的一致性封装。Koa 不内置任何中间件路由、静态文件、模板引擎这些都需要自己接入。环境要求Koa 需要 Node.js v18.0.0 或更高版本因为它依赖 ES2015 和 async/await 特性。安装方式很简单npm install koa一个最基础的示例constKoarequire(koa);constappnewKoa();app.use(ctx{ctx.bodyHello Koa;});app.listen(3000);中间件机制Koa 支持两种形式的中间件async 函数和普通函数。async 函数的写法app.use(async(ctx,next){conststartDate.now();awaitnext();constmsDate.now()-start;console.log(${ctx.method}${ctx.url}-${ms}ms);});普通函数的写法需要返回 Promiseapp.use((ctx,next){conststartDate.now();returnnext().then((){constmsDate.now()-start;console.log(${ctx.method}${ctx.url}-${ms}ms);});});需要注意的是Koa v1.x 的中间件签名已经废弃v3 版本中旧签名支持已被移除。升级时可以参考官方提供的迁移指南。Context、Request 和 Response每个中间件都会接收一个 Context 对象它封装了这次请求的全部信息。ctx 是常用的参数名。app.use(async(ctx,next){awaitnext();});Koa 在 Context 上挂载了 Request 和 Response 两个对象分别代理了 Node.js 原生的 IncomingMessage 和 ServerResponse。它没有直接扩展原生对象而是通过代理来提供更干净的接口这样做减少了中间件之间的冲突对流式处理的支持也更好。比如检查客户端是否支持 XMLapp.use(async(ctx,next){ctx.assert(ctx.request.accepts(xml),406);awaitnext();});再比如用流的方式返回文件app.use(async(ctx,next){awaitnext();ctx.response.typexml;ctx.response.bodyfs.createReadStream(really_large.xml);});Context 还提供了快捷方式。比如 ctx.type 等同于 ctx.response.typectx.accepts 等同于 ctx.request.accepts。Koa 应用对象执行 new Koa() 创建的实例就是应用对象。它负责与 Node.js 的 HTTP 服务器对接处理中间件注册、请求分发、默认错误处理以及 Context、Request、Response 的配置。适用场景Koa 适合需要精细控制请求处理流程的项目。它的中间件机制让每个环节的职责明确代码结构比较清晰。由于框架本身很轻加上中间件都是按需引入最终打包的体积可以控制得比较小。对于熟悉 Express 但想要更现代的异步写法的开发者来说Koa 是一个可选方案。它的学习曲线不陡文档也比较完整涵盖了使用指南、错误处理、API 参考等内容。Koa 采用 MIT 协议开源。对于熟悉 Express 但想要更现代的异步写法的开发者来说Koa 是一个可选方案。它的学习曲线不陡文档也比较完整涵盖了使用指南、错误处理、API 参考等内容。Koa 采用 MIT 协议开源。