⚡ 30 秒速记

• 核心判断：服务端框架把请求、响应和中间件组合成可控制的处理链，核心是调用顺序与错误传播
• 原理主线：围绕 「一、基本用法」、「二、路由」、「三、中间件」 建立输入、状态变化与输出之间的因果关系
• 文章范围：系统总结了Koa框架的基本用法，包括如何搭建HTTP服务、使用Context对象处理请求与响应、设置返回内容类型等核心知识，适合Node.js开发者快速上手和理解Koa原理。
• 边界与代价：Koa 洋葱模型依赖 await next()，遗漏等待或重复写响应会破坏上下游时序
• 工程落地：中间件应明确是否继续、何时回收资源、错误由谁处理，并用请求级上下文隔离状态

Koa 的基本用法，是通过 Context 读写请求和响应，再用中间件把处理逻辑串成洋葱式执行链。 路由、静态资源、表单和文件上传通常交给对应中间件，业务代码只需修改 ctx.body、状态码或响应类型。异步中间件要写成 async，并用 await next() 保证下游完成后再执行回程逻辑。错误处理一般放在最外层统一捕获，同时可监听 error 事件记录异常。

这篇文章不要按 API 清单来背。先用上面的 Mind Map 建立全局结构，再通过交互 DEMO 观察正常路径和边界路径如何改变状态；阅读正文时重点核对每一步的输入、负责执行的参与者、产生的中间状态以及最终可观察结果。遇到版本敏感结论，要把“历史实现”“当前行为”和“工程兼容策略”分开说明；遇到性能或架构取舍，则用实际指标、失败现象和验证手段支撑判断。

版本校准： Node.js 的事件循环阶段名称相对稳定，但定时器、微任务和底层 libuv 行为会随主版本变化。回答时必须先报运行版本，再用最小脚本验证顺序；不要把浏览器事件循环或某个旧版本输出当作所有 Node.js 版本的固定结论。

Koa 就是一种简单好用的 Web 框架。它的特点是优雅、简洁、表达力强、自由度高

一、基本用法

1.1 架设 HTTP 服务

只要三行代码，就可以用 Koa 架设一个 HTTP 服务。

const Koa = require('koa');
const app = new Koa();

app.listen(3000);

打开浏览器，访问http://127.0.0.1:3000 。你会看到页面显示"Not Found"，表示没有发现任何内容。这是因为我们并没有告诉 Koa 应该显示什么内容

1.2 Context 对象

Koa 提供一个 Context 对象，表示一次对话的上下文（包括 HTTP 请求和 HTTP 回复）。通过加工这个对象，就可以控制返回给用户的内容

• Context.response.body属性就是发送给用户的内容

const Koa = require("koa");
const app = new Koa();

app.use(ctx => { //处理请求的中间件
    ctx.response.body = "hello world";
}).listen(3000);