前言

作为一名 Node.js 开发者，选择合适的后端框架往往是项目初期最关键的决策之一。Express 作为"老前辈"长期主导 Node.js 的 Web 开发领域，而由同一团队打造的 Koa 则被视为 Express 的"精神继承者"。在过去几年的实际项目中，我先后使用过这两个框架，今天就来分享一下它们的核心差异和各自的适用场景。

架构设计对比

Express：成熟稳定的全能选手

Express 采用传统的中间件流程设计，每个中间件按顺序执行，并通过next()函数将控制权传递给下一个中间件：

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

app.use((req, res, next) => {
  console.log("中间件1处理请求");
  next();
  console.log("中间件1后续处理");
});

app.use((req, res, next) => {
  console.log("中间件2处理请求");
  res.send("Hello World");
});

app.listen(3000);

运行结果：

中间件1处理请求
中间件2处理请求
中间件1后续处理

Express 的 API 设计简单直观，内置了路由功能和大量实用工具，这意味着你可以快速上手并构建功能完整的应用。

Koa：精简强大的现代框架

Koa 采用洋葱模型架构，所有请求会从外到内穿过中间件层，然后响应从内到外返回：

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

app.use(async (ctx, next) => {
  console.log("中间件1处理请求");
  await next();
  console.log("中间件1处理响应");
});

app.use(async (ctx, next) => {
  console.log("中间件2处理请求");
  ctx.body = "Hello World";
  console.log("中间件2处理响应");
});

app.listen(3000);

运行结果：

中间件1处理请求
中间件2处理请求
中间件2处理响应
中间件1处理响应

Koa 专注于核心功能，体积更小，默认不包含路由、静态文件等功能，需要通过插件扩展。它的设计更加现代，原生支持 async/await，错误处理更加优雅。

核心 API 设计差异

请求和响应对象

Express：分离的 req 和 res 对象

app.get("/user/:id", (req, res) => {
  const userId = req.params.id;
  const userAgent = req.headers["user-agent"];

  res.status(200).json({ id: userId, agent: userAgent });
});

Koa：统一的 ctx 上下文对象

router.get("/user/:id", async (ctx) => {
  const userId = ctx.params.id;
  const userAgent = ctx.request.headers["user-agent"];

  ctx.status = 200;
  ctx.body = { id: userId, agent: userAgent };
});

中间件实现

Express中间件：基于回调函数

function authMiddleware(req, res, next) {
  if (!req.headers.authorization) {
    return res.status(401).send("未授权");
  }
  next();
}

Koa中间件：基于 async/await

async function authMiddleware(ctx, next) {
  if (!ctx.headers.authorization) {
    ctx.status = 401;
    ctx.body = "未授权";
    return;
  }
  await next();
}

错误处理

Express错误处理：通过 try-catch 或专用错误中间件

app.get("/error", (req, res, next) => {
  try {
    throw new Error("测试错误");
  } catch (err) {
    next(err);
  }
});

app.use((err, req, res, next) => {
  console.error(err);
  res.status(500).send("服务器错误");
});

Koa错误处理：通过 try-catch 或 app.on('error')

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

app.on("error", (err, ctx) => {
  console.error("服务器错误", err);
});

性能对比

在实际项目中，我对两个框架做了一些简单的性能测试，这里分享一些结果：

基准测试结果（简单 JSON 响应，10000 请求，并发 100）

框架	请求/秒	平均响应时间	内存使用
Express	~4,500	21.8ms	~60MB
Koa	~5,200	19.2ms	~45MB

Koa 在简单场景下性能略胜一筹，主要原因是其更精简的架构和更低的中间件开销。但需要注意，当加入更多第三方中间件后，这种差异可能会减小。

中间件生态对比

Express 的中间件生态

Express 拥有庞大而成熟的中间件生态，官方维护的中间件如：

express.json() - 处理 JSON 请求体
express.urlencoded() - 处理表单数据
express.static() - 提供静态文件服务

以及大量社区中间件：

morgan - 请求日志记录
helmet - 安全 HTTP 头设置
passport - 身份认证
multer - 文件上传处理

几乎所有 Web 开发需求都能找到对应的 Express 中间件。

Koa 的中间件生态

Koa 的中间件更为精简，常用中间件：

koa-router - 路由处理
koa-bodyparser - 请求体解析
koa-static - 静态文件服务
koa-session - Session 管理
koa-jwt - JWT 认证

Koa 的中间件通常设计得更加专注和模块化，遵循"小而美"的原则。

真实项目案例分析

案例 1：REST API 服务

在一个需要处理大量并发请求的 API 服务项目中，我们选择了 Koa，原因是：

对 async/await 的原生支持使异步代码更清晰
洋葱模型中间件对于复杂请求处理流程更有优势
更低的内存占用对于高并发场景更友好

关键代码示例：

// 用户认证中间件
const auth = async (ctx, next) => {
  const token = ctx.headers.authorization;
  if (!token) {
    ctx.throw(401, "未授权访问");
  }

  try {
    ctx.state.user = await verifyToken(token);
    await next();
    // 在响应阶段添加额外处理
    ctx.set("X-Response-Time", `${Date.now() - ctx.state.startTime}ms`);
  } catch (err) {
    ctx.throw(401, "无效的认证令牌");
  }
};

router.get("/protected", auth, async (ctx) => {
  ctx.body = { data: "受保护的数据", user: ctx.state.user };
});

案例 2：内容管理系统

在一个包含视图渲染的内容管理系统中，我们选择了 Express，原因是：

内置的视图渲染功能更易于使用
丰富的中间件生态减少了开发工作量
更全面的文档和社区支持加快了开发速度

关键代码示例：

// 设置模板引擎
app.set("view engine", "ejs");

// 添加Flash消息中间件
app.use(flash());

// 管理员控制面板路由
app.get("/admin/dashboard", isAdmin, (req, res) => {
  res.render("admin/dashboard", {
    user: req.user,
    stats: getSystemStats(),
    flashMessages: req.flash(),
  });
});

如何选择？实用决策指南

基于我的实际经验，以下是选择框架的一些建议：

选择 Express 的场景：

需要快速开发有完整功能的 Web 应用
团队更熟悉回调风格的异步处理
项目需要大量现成的中间件支持
需要构建包含视图渲染的传统网站

选择 Koa 的场景：

构建现代 API 服务或微服务
偏好 async/await 语法和更清晰的错误处理
需要精细控制请求/响应周期
项目对性能和内存使用有较高要求

迁移策略：从 Express 到 Koa

如果你正考虑将现有 Express 项目迁移到 Koa，这里是一些实用建议：

渐进式迁移：不必一次性重写所有代码，可以先将新功能用 Koa 实现，然后逐步替换旧功能
调整中间件思维：重新思考中间件的设计，利用洋葱模型的特性

中间件适配：使用 koa-connect 包可以将 Express 中间件适配到 Koa 中使用

const koaConnect = require("koa-connect");
const expressMiddleware = require("some-express-middleware");

app.use(koaConnect(expressMiddleware()));

统一错误处理：重新设计错误处理策略，利用 Koa 的集中式错误处理

结语

Express 和 Koa 都是出色的 Node.js Web 框架，它们的设计理念和实现方式各有千秋。作为开发者，我们不应该盲目追求最新的技术，而是要根据项目的实际需求和团队的技术背景做出明智的选择。

在我目前的实践中，对于 API 服务和需要精细控制的场景，通常会选择 Koa；而对于快速开发完整 Web 应用或团队更熟悉 Express 的情况，仍会选择 Express。

无论选择哪个框架，掌握其核心设计理念和最佳实践，才能充分发挥框架的优势，构建高质量的 Node.js 应用。

前言