Node.js Web 框架深度对比：Express, Fastify, Koa, Hapi 与 Sails

在 Node.js 后端开发中，选择合适的 Web 框架直接影响项目的性能、维护成本和开发体验。express、fastify、koa、hapi 和 sails 代表了五种不同的设计思路。本文将从架构设计、代码写法、性能验证和维护状态五个维度进行深度对比。

🏗️ 核心架构：中间件 vs 插件 vs MVC

express 采用线性中间件模型。

• 请求按顺序通过中间件栈。
• 简单易用，但错误处理有时需要手动传递。

// express: 线性中间件
app.use((req, res, next) => {
  console.log('Time:', Date.now());
  next();
});

fastify 采用插件化架构。

• 功能通过插件封装，避免全局污染。
• 支持封装上下文，适合大型项目模块化。

// fastify: 插件注册
fastify.register(async (instance) => {
  instance.get('/route', (req, reply) => {
    reply.send({ hello: 'world' });
  });
});

koa 采用洋葱模型中间件。

• 中间件通过 await next() 控制流程。
• 支持在请求前后执行逻辑，更灵活。

// koa: 洋葱模型
app.use(async (ctx, next) => {
  console.log('Before');
  await next();
  console.log('After');
});

hapi 采用配置驱动架构。

• 逻辑通过配置对象定义，而非代码堆砌。
• 强调安全性和可扩展性，代码量较少。

// hapi: 配置路由
server.route({
  method: 'GET',
  path: '/',
  options: {
    handler: (request, h) => 'Hello'
  }
});

sails 采用 MVC 全栈架构。

• 内置控制器、模型、视图和路由。
• 约定优于配置，适合传统 Web 应用。

// sails: 控制器动作
module.exports = {
  fn: async function (req, res) {
    return res.ok('Hello');
  }
};

📝 请求与响应处理：对象与上下文

处理请求数据的方式决定了代码的简洁度。

express 使用 req 和 res 对象。

• 分离明确，但需要手动发送响应。
• 社区中间件最丰富。

// express:  req/res 分离
app.get('/user', (req, res) => {
  res.json({ id: req.query.id });
});

fastify 使用 req 和 reply 对象。

• reply 对象提供链式调用。
• 默认自动序列化 JSON，性能更高。

// fastify: req/reply 链式
fastify.get('/user', (req, reply) => {
  return { id: req.query.id }; // 自动发送
});

koa 使用统一的 ctx 上下文。

• 所有数据挂载在 ctx 上。
• 代码更简洁，但需要适应新对象。

// koa: ctx 统一上下文
app.use(async (ctx) => {
  ctx.body = { id: ctx.query.id };
});

hapi 使用 request 和 h 响应工具。

• h 对象提供响应构建方法。
• 结构严谨，适合复杂验证。

// hapi: request/h 工具
server.route({
  method: 'GET',
  path: '/user',
  handler: (request, h) => {
    return { id: request.query.id };
  }
});

sails 使用 req 和 res 但封装在动作中。

• 内置 res.ok, res.serverError 等 helper。
• 简化了常见响应场景。

// sails: 内置响应 helper
module.exports = {
  fn: async function (req, res) {
    return res.json({ id: req.param('id') });
  }
};

🛡️ 验证与性能：手动 vs 自动

express 默认无验证，需手动或引入库。

• 灵活但容易遗漏。
• 性能中等，适合通用场景。

// express: 手动验证
app.post('/data', (req, res) => {
  if (!req.body.email) return res.status(400).send('Missing');
  res.send('OK');
});

fastify 内置 JSON Schema 验证。

• 自动验证请求体和参数。
• 性能极高，适合高并发。

// fastify: Schema 验证
fastify.post('/data', {
  schema: {
    body: {
      type: 'object',
      required: ['email'],
      properties: { email: { type: 'string' } }
    }
  }
}, (req, reply) => {
  reply.send('OK'); // 自动验证失败返回 400
});

koa 无内置验证，依赖中间件。

• 需自行组装 koa-bodyparser 等。
• 性能优秀，取决于中间件选择。

// koa: 中间件验证
app.use(async (ctx, next) => {
  if (!ctx.request.body.email) {
    ctx.status = 400;
    return;
  }
  await next();
});

hapi 内置强大验证库 (Joi)。

• 配置化验证，代码清晰。
• 性能略低于 Fastify，但安全性高。

// hapi: Joi 验证配置
server.route({
  method: 'POST',
  path: '/data',
  options: {
    validate: {
      payload: Joi.object({ email: Joi.string().required() })
    },
    handler: (request, h) => 'OK'
  }
});

sails 内置 Waterline ORM 验证。

• 模型层定义验证规则。
• 性能较重，适合数据密集型应用。

// sails: 模型层验证
// api/models/User.js
attributes: {
  email: { type: 'string', required: true }
}

⚠️ 维护状态与弃用警告

hapi 包名已变更。

• 原 hapi 包已弃用，新项目不应使用。
• 必须使用 @hapi/hapi scoped 包。
• 社区活跃度较以前下降，但仍在维护。

sails 更新节奏较慢。

• 未被弃用，但架构较传统。
• 适合维护旧项目，新项目需权衡重量。

express, fastify, koa 均活跃维护。

• express 进入稳定期，变化少。
• fastify 迭代快，性能持续优化。
• koa 保持稳定，适合现代语法偏好者。

📊 核心特性对比表

💡 选型建议

express 是通用型选择 🧰。

• 适合大多数 API 服务和 SSR 应用。
• 遇到问题容易找到答案，生态最成熟。

fastify 是性能型选择 🚀。

• 适合高并发微服务和对延迟敏感的系统。
• 内置验证减少了样板代码，开发效率高。

koa 是现代化选择 🌱。

• 适合喜欢 async/await 和轻量级的团队。
• 没有历史包袱，代码更干净。

hapi 是规范型选择 📜。

• 适合大型企业需要严格配置标准的场景。
• 注意必须使用 @hapi/hapi 包。

sails 是全栈型选择 🏗️。

• 适合快速构建数据驱动的传统 Web 应用。
• 内置功能多，但灵活性不如微框架。

总结

没有绝对最好的框架，只有最适合场景的工具。如果你追求稳定和生态，选 express；追求性能和验证，选 fastify；追求现代语法，选 koa。对于 hapi，请确保使用新包名；对于 sails，请确认你需要的是全栈框架而非轻量 API 服务。