目录

Node.jsExpress-和-Koa-中间件的区别

【Node.js】Express 和 Koa 中间件的区别

1. Express 中间件

特点

  • 基于回调链(next 传递控制权)
  • 中间件本质就是 (req, res, next) 的函数。
  • 执行顺序是 线性串行,一旦调用 next() 就会交给下一个中间件。

示例

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

// 中间件1
app.use((req, res, next) => {
  console.log('middleware 1 start')
  next() // 交给下一个
  console.log('middleware 1 end') // 不会等后面的异步
})

// 中间件2
app.use((req, res, next) => {
  console.log('middleware 2')
  next()
})

app.listen(3000)

👉 特点是 没有“洋葱模型”,执行顺序就是一条直线:

middleware 1 start
middleware 2
middleware 1 end   // 注意这里不是“包裹”,而是直接继续执行

2. Koa 中间件

特点

  • 基于 async/await 实现。
  • 使用的是 洋葱模型:先进入外层中间件 → 一直到底 → 然后再从底层往外层“返回”。
  • 中间件函数签名:async (ctx, next)

示例

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

// 中间件1
app.use(async (ctx, next) => {
  console.log('middleware 1 start')
  await next() // 等待下一个中间件完成
  console.log('middleware 1 end') // 这里会在“返回来”的时候执行
})

// 中间件2
app.use(async (ctx, next) => {
  console.log('middleware 2 start')
  await next()
  console.log('middleware 2 end')
})

app.listen(3000)

👉 执行顺序:

middleware 1 start
middleware 2 start
middleware 2 end
middleware 1 end

这就是 典型的洋葱模型


3. 核心区别总结

特性ExpressKoa (2.x)
中间件形式(req, res, next)async (ctx, next)
控制流next() 直接进入下一个await next() 形成洋葱模型
上下文对象req + res 分开统一 ctx 封装请求响应
异步处理需要手动调用 next 并处理回调基于 async/await,天然异步
可读性与优雅性回调风格,复杂逻辑容易乱更优雅、直观

📌 一句话总结

  • Express 的中间件是 线性流水线
  • Koa 的中间件是 洋葱模型(更符合异步逻辑)。