Koa2通过洋葱模型实现中间件的执行，请求时逐层进入，响应时逐层返回。每个中间件在await next()前后分别处理请求和响应阶段，结合async/await实现异步控制，compose函数递归调度中间件，确保按序执行。该机制适用于日志、错误处理、权限校验等场景，提升了代码可读性与可维护性。
Koa2 是一个基于 Node.js 的轻量级 Web 框架，它的核心设计思想是通过中间件机制来处理 HTTP 请求。与传统的回调或 Promise 链不同，Koa2 利用 ES6 的 generator 和 async/await 特性，实现了更优雅的控制流管理。理解 Koa2 中间件原理，关键在于掌握其洋葱模型（onion model）和异步流程控制。
中间件的基本结构
Koa2 的中间件是一个函数，接收上下文 ctx 和下一个中间件函数 next 作为参数：
async (ctx, next) => {
// 前置逻辑（进入时）
await next();
// 后置逻辑（退出时）
}
这里的 next() 调用表示将控制权传递给下一个中间件。调用 await next() 是关键，它确保当前中间件能等待后续中间件执行完成后再继续执行自己的后半部分逻辑。
洋葱模型的工作机制
Koa2 的中间件采用“洋葱模型”组织执行顺序。多个中间件像洋葱层一样包裹在一起，请求从外向内逐层进入，到达最内层后，再从内向外逐层返回。
立即学习“Java免费学习笔记（深入）”；
例如有三个中间件：
// 中间件1
app.use(async (ctx, next) => {
console.log('1-进入');
await next();
console.log('1-退出');
});
// 中间件2
app.use(async (ctx, next) => {
console.log('2-进入');
await next();
console.log('2-退出');
});
// 中间件3
app.use(async (ctx, next) => {
console.log('3-进入');
ctx.body = 'Hello World';
await next();
console.log('3-退出');
});
输出结果为：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
这个顺序体现了请求层层深入、响应层层回溯的过程，使得每个中间件可以在请求和响应两个阶段进行处理，非常适合日志记录、权限校验、异常捕获等场景。
中间件的组合机制
Koa 内部使用 compose 函数将多个中间件合并成一个可执行的函数。这个函数递归地调用每一个中间件，并传入当前的 ctx 和指向下一个中间件的 next。
compose 的简化实现如下：
function compose(middleware) {
return function(ctx, next) {
let index = -1;
return dispatch(0);
function dispatch(i) {
if (i <= index) throw new Error('next() called multiple times');
index = i;
let fn = middleware[i];
if (i === middleware.length) fn = next;
if (!fn) return Promise.resolve();
try {
return Promise.resolve(fn(ctx, () => dispatch(i + 1)));
} catch (err) {
return Promise.reject(err);
}
}
};
}
这个机制保证了中间件按顺序执行，并且通过 Promise 链实现了异步控制。每调用一次 next()，实际是触发了 dispatch(i+1)，进入下一个中间件，直到所有中间件执行完毕，再逐层返回。
常见中间件应用场景
Koa2 的中间件机制非常灵活，可用于多种功能扩展：
- 日志记录：在请求进入和响应结束时打印时间、路径等信息
- 错误处理：顶层中间件捕获后续任意中间件抛出的异常
- 身份验证：检查用户登录状态，未登录则中断流程
- 响应压缩：对输出内容进行 gzip 压缩
- CORS 支持：设置跨域头信息
基本上就这些。Koa2 的中间件原理看似简单，但其结合 async/await 和洋葱模型的设计，极大提升了代码的可读性和可维护性。只要理解了 await next() 的作用和执行顺序，就能写出清晰高效的中间件逻辑。不复杂但容易忽略细节。
