Koa：Node.js 的轻量中间件框架

Koa：Node.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

一个最基础的示例：

constKoa=require('koa');constapp=newKoa();app.use(ctx=>{ctx.body='Hello Koa';});app.listen(3000);

中间件机制

Koa 支持两种形式的中间件：async 函数和普通函数。

async 函数的写法：

app.use(async(ctx,next)=>{conststart=Date.now();awaitnext();constms=Date.now()-start;console.log(`${ctx.method}${ctx.url}-${ms}ms`);});

普通函数的写法，需要返回 Promise：

app.use((ctx,next)=>{conststart=Date.now();returnnext().then(()=>{constms=Date.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。它没有直接扩展原生对象，而是通过代理来提供更干净的接口，这样做减少了中间件之间的冲突，对流式处理的支持也更好。

比如检查客户端是否支持 XML：

app.use(async(ctx,next)=>{ctx.assert(ctx.request.accepts('xml'),406);awaitnext();});

再比如用流的方式返回文件：

app.use(async(ctx,next)=>{awaitnext();ctx.response.type='xml';ctx.response.body=fs.createReadStream('really_large.xml');});

Context 还提供了快捷方式。比如 ctx.type 等同于 ctx.response.type，ctx.accepts 等同于 ctx.request.accepts。

Koa 应用对象

执行 new Koa() 创建的实例就是应用对象。它负责与 Node.js 的 HTTP 服务器对接，处理中间件注册、请求分发、默认错误处理，以及 Context、Request、Response 的配置。

适用场景

Koa 适合需要精细控制请求处理流程的项目。它的中间件机制让每个环节的职责明确，代码结构比较清晰。由于框架本身很轻，加上中间件都是按需引入，最终打包的体积可以控制得比较小。

对于熟悉 Express 但想要更现代的异步写法的开发者来说，Koa 是一个可选方案。它的学习曲线不陡，文档也比较完整，涵盖了使用指南、错误处理、API 参考等内容。

Koa 采用 MIT 协议开源。

对于熟悉 Express 但想要更现代的异步写法的开发者来说，Koa 是一个可选方案。它的学习曲线不陡，文档也比较完整，涵盖了使用指南、错误处理、API 参考等内容。

Koa 采用 MIT 协议开源。