Express 5 vs Fastify 对比

// Express 5 - 异步路由处理函数 + 自动错误捕获
import express from 'express';

const app = express();
app.use(express.json());

// 简单的错误类 —— 用于在 API 边界给出有意义的错误信息
class NotFoundError extends Error {
  status = 404;
}

async function getUser(id) {
  const user = await db.users.findById(id);
  if (!user) throw new NotFoundError('User not found');
  return user;
}

// Express 5:异步处理函数 reject 或 throw 时会自动调用 next(err)。
// 别忘了 return 这个 Promise —— 否则 rejection 可能变成 unhandled。
app.get('/api/users/:id', async (req, res) => {
  const user = await getUser(req.params.id);
  res.json(user);
});

// 集中式错误中间件 —— 添加在全局栈的末尾
app.use((err, req, res, next) => {
  const status = err.status ?? 500;
  res.status(status).json({ error: err.message });
});

app.listen(3000, () => {
  console.log('Express server listening on port 3000');
});

// Fastify 5 - Schema 校验 + 自动序列化
import Fastify from 'fastify';

const fastify = Fastify({ logger: true });

// 响应 Schema:fast-json-stringify 会基于这个 Schema
// 编译出一个专用的序列化函数 —— 比通用的 JSON.stringify 更快。
const userSchema = {
  type: 'object',
  properties: {
    id: { type: 'string' },
    name: { type: 'string' },
    email: { type: 'string' },
  },
  required: ['id', 'name', 'email'],
};

const getUserOpts = {
  schema: {
    params: {
      type: 'object',
      properties: { id: { type: 'string' } },
      required: ['id'],
    },
    response: {
      200: userSchema,
    },
  },
};

// 封装隔离:在这个插件内注册的 hook/decorator
// 只会渗透到这个 context 下的路由。
fastify.register(async function userRoutes(instance) {
  instance.get('/api/users/:id', getUserOpts, async (request, reply) => {
    const user = await db.users.findById(request.params.id);
    if (!user) {
      return reply.code(404).send({ error: 'User not found' });
    }
    request.log.info({ userId: user.id }, 'user fetched');
    return user;
  });
});

fastify.setErrorHandler((error, request, reply) => {
  reply.status(error.statusCode ?? 500).send({ error: error.message });
});

await fastify.listen({ port: 3000 });