Node.js 中间件设计：Koa 与 Express 对比实践

一、中间件核心概念

1. 作用：处理 HTTP 请求/响应周期，实现日志、鉴权、数据解析等通用功能。
2. 执行流程：
   • 线性管道：中间件按注册顺序执行
   • 控制传递：通过 next()（Express）或 await next()（Koa）移交控制权

---

二、Express 中间件设计

1. 核心特点

   • 基于回调函数的同步/异步流程
   • 直接操作 req/res 对象
   • 错误处理需特殊中间件签名 (err, req, res, next)

2. 典型实现

const express = require('express');
const app = express();

// 日志中间件
app.use((req, res, next) => {
  console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);
  next(); // 必须显式调用
});

// 路由级中间件
app.get('/user', authMiddleware, (req, res) => {
  res.send('Authenticated!');
});

// 错误处理（4个参数）
app.use((err, req, res, next) => {
  res.status(500).send('Server Error');
});

1. 关键局限
   • 回调地狱风险
   • 需手动传递错误（无法自动冒泡）
   • req/res 分离导致状态管理复杂

---

三、Koa 中间件设计

1. 核心创新

   • 洋葱模型：通过 async/await 实现双向控制流
   • 统一上下文：所有操作通过 ctx 对象（封装请求/响应）
   • 错误冒泡：自动传递到顶层错误处理

2. 洋葱模型示例

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

// 中间件1
app.use(async (ctx, next) => {
  console.log('Start mid1');
  await next();  // 暂停并执行下游中间件
  console.log('End mid1'); // 返回执行
});

// 中间件2
app.use(async ctx => {
  ctx.body = 'Hello Koa!';
});

执行顺序：
Start mid1 → 中间件2 → End mid1

1. 错误处理优势

app.use(async (ctx, next) => {
  try {
    await next();
  } catch (err) {
    ctx.status = 500;
    ctx.body = { error: err.message };
  }
});

---

四、关键对比

特性	Express	Koa
架构基础	回调函数	async/await + Promise
上下文	分离的 req/res	统一的 ctx 对象
控制流	线性单向	双向洋葱模型
错误处理	需特殊中间件	try/catch 自然冒泡
代码风格	可能产生回调嵌套	同步式异步代码
生态扩展	更成熟（e.g. express-session)	轻量（依赖中间件库如 koa-router)

---

五、实践建议

1. 选择场景

   • 选 Express：需要兼容旧系统/使用特定中间件
   • 选 Koa：新项目/需要精细异步控制/TypeScript 友好

2. 混合使用方案

// 在 Koa 中嵌入 Express 中间件
const expressMiddleware = require('express-middleware');
app.use(koaConnect(expressMiddleware));

1. 性能注意
   • Koa 的 async/await 有轻微性能开销（可忽略）
   • Express 同步中间件阻塞事件循环

终极建议：中小项目首选 Koa（代码更简洁），大型稳定项目可沿用 Express。

---

六、总结

框架	哲学	适用场景
Express	"最小化干预"	快速开发/传统回调项目
Koa	"优雅的流程控制"	现代异步应用/需要精细控制

通过理解中间件设计差异，可针对性地构建高可维护性的 Node.js 服务。