从 Fastify 到 Vafast

本指南适用于希望了解 Fastify 与 Vafast 之间差异的 Fastify 用户，包括语法，以及如何通过示例将应用程序从 Fastify 迁移到 Vafast。

Fastify 是一个专注于提供最大效率和速度的 Node.js Web 框架，具有低内存占用和优秀的性能。

Vafast 是一个专为 Bun 运行时设计的高性能 Web 框架，专注于类型安全、中间件系统和性能优化。设计时强调简单性和开发者友好，提供完整的 TypeScript 支持。

性能

由于专为 Bun 运行时优化和智能路由匹配算法，Vafast 在性能上相比 Fastify 有显著提高。

Vafast
2,454,631 reqs/s
Fastify
415,600

Measured in requests/second. Result from TechEmpower Benchmark Round 22 (2023-10-17) in PlainText

路由

Fastify 和 Vafast 都使用配置对象的方式定义路由，但 Vafast 提供了更简洁的 API 和更好的类型安全。

Fastify

import Fastify from 'fastify'

const fastify = Fastify()

fastify.get('/', async (request, reply) => {
  return { hello: 'world' }
})

fastify.post('/user/:id', async (request, reply) => {
  const { id } = request.params
  const { name } = request.body
  return { id, name }
})

await fastify.listen({ port: 3000 })

Fastify 使用 request 和 reply 作为请求和响应对象

Vafast

import { Server, defineRoutes, createHandler } from 'vafast'

const routes = defineRoutes([
  {
    method: 'GET',
    path: '/',
    handler: createHandler(() => {
      return { hello: 'world' }
    })
  },
  {
    method: 'POST',
    path: '/user/:id',
    handler: createHandler(({ params, body }) => {
      return { id: params.id, name: body.name }
    })
  }
])

const server = new Server(routes)
export default { fetch: server.fetch }

Vafast 使用配置对象定义路由，支持类型安全和中间件

主要差异

1. 路由定义方式

Fastify 使用链式方法调用：

typescript

fastify.get('/users', async (request, reply) => { ... })
fastify.post('/users', async (request, reply) => { ... })

Vafast 使用配置对象数组：

typescript

const routes = defineRoutes([
  {
    method: 'GET',
    path: '/users',
    handler: createHandler(() => { ... })
  },
  {
    method: 'POST',
    path: '/users',
    handler: createHandler(() => { ... })
  }
])

2. 请求处理

Fastify 使用 request 和 reply 对象：

typescript

fastify.get('/user/:id', async (request, reply) => {
  const id = request.params.id
  const query = request.query
  return { id, query }
})

Vafast 使用解构参数：

typescript

{
  method: 'GET',
  path: '/user/:id',
  handler: createHandler(({ params, query }) => {
    return { id: params.id, query }
  })
}

3. Schema 验证

Fastify 使用内置的 JSON Schema 验证：

typescript

const userSchema = {
  type: 'object',
  properties: {
    name: { type: 'string' },
    age: { type: 'number' }
  },
  required: ['name']
}

fastify.post('/users', {
  schema: {
    body: userSchema
  }
}, async (request, reply) => {
  return createUser(request.body)
})

Vafast 使用 TypeBox 进行验证：

typescript

import { Type } from '@sinclair/typebox'

const userSchema = Type.Object({
  name: Type.String(),
  age: Type.Optional(Type.Number())
})

{
  method: 'POST',
  path: '/users',
  handler: createHandler(({ body }) => {
    return createUser(body)
  }),
  body: userSchema
}

4. 中间件系统

Fastify 使用钩子（hooks）和插件系统：

typescript

fastify.addHook('preHandler', async (request, reply) => {
  console.log(`${request.method} ${request.url}`)
})

fastify.register(async function (fastify) {
  fastify.get('/admin', async (request, reply) => {
    return 'Admin Panel'
  })
})

Vafast 支持全局和路由级中间件：

typescript

const loggingMiddleware = async (req: Request, next: () => Promise<Response>) => {
  console.log(`${req.method} ${req.url}`)
  return await next()
}

const server = new Server(routes)
server.use(loggingMiddleware)

const routes = defineRoutes([
  {
    method: 'GET',
    path: '/admin',
    handler: createHandler(() => 'Admin Panel'),
    middleware: [authMiddleware]
  }
])

5. 错误处理

Fastify 使用错误处理器：

typescript

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

Vafast 支持中间件链中的错误处理：

typescript

const errorHandler = async (req: Request, next: () => Promise<Response>) => {
  try {
    return await next()
  } catch (error) {
    return new Response(
      JSON.stringify({ error: error.message }), 
      { status: 500 }
    )
  }
}

迁移步骤

步骤 1: 安装 Vafast

bash

bun add vafast

步骤 2: 重构路由定义

将 Fastify 的路由定义转换为 Vafast 的配置对象格式：

typescript

// Fastify 风格
fastify.get('/api/users', async (request, reply) => {
  const users = getUsers()
  return users
})

// Vafast 风格
{
  method: 'GET',
  path: '/api/users',
  handler: createHandler(() => {
    return getUsers()
  })
}

步骤 3: 更新 Schema 验证

将 Fastify 的 JSON Schema 转换为 TypeBox：

typescript

// Fastify Schema
const userSchema = {
  type: 'object',
  properties: {
    name: { type: 'string', minLength: 1 },
    email: { type: 'string', format: 'email' }
  },
  required: ['name', 'email']
}

// Vafast Schema
import { Type } from '@sinclair/typebox'

const userSchema = Type.Object({
  name: Type.String({ minLength: 1 }),
  email: Type.String({ format: 'email' })
})

步骤 4: 更新中间件和钩子

typescript

// Fastify 钩子
fastify.addHook('preHandler', async (request, reply) => {
  const token = request.headers.authorization
  if (!token) {
    reply.status(401).send('Unauthorized')
  }
})

// Vafast 中间件
const authMiddleware = async (req: Request, next: () => Promise<Response>) => {
  const token = req.headers.get('authorization')
  if (!token) {
    return new Response('Unauthorized', { status: 401 })
  }
  return await next()
}

步骤 5: 更新错误处理

typescript

// Fastify 错误处理
fastify.setErrorHandler((error, request, reply) => {
  reply.status(500).send({ error: error.message })
})

// Vafast 错误处理
const errorHandler = async (req: Request, next: () => Promise<Response>) => {
  try {
    return await next()
  } catch (error) {
    return new Response(
      JSON.stringify({ error: error.message }), 
      { status: 500 }
    )
  }
}

完整迁移示例

Fastify 应用

typescript

import Fastify from 'fastify'
import cors from '@fastify/cors'
import helmet from '@fastify/helmet'

const fastify = Fastify()

await fastify.register(cors)
await fastify.register(helmet)

fastify.get('/users', async (request, reply) => {
  const users = getUsers()
  return users
})

fastify.post('/users', {
  schema: {
    body: {
      type: 'object',
      properties: {
        name: { type: 'string' },
        email: { type: 'string' }
      },
      required: ['name', 'email']
    }
  }
}, async (request, reply) => {
  const user = createUser(request.body)
  reply.status(201)
  return user
})

fastify.get('/users/:id', async (request, reply) => {
  const user = getUserById(request.params.id)
  if (!user) {
    reply.status(404)
    return { error: 'User not found' }
  }
  return user
})

await fastify.listen({ port: 3000 })

Vafast 应用

typescript

import { Server, defineRoutes, createHandler } from 'vafast'
import { cors } from '@vafast/cors'
import { helmet } from '@vafast/helmet'
import { Type } from '@sinclair/typebox'

const userSchema = Type.Object({
  name: Type.String(),
  email: Type.String()
})

const routes = defineRoutes([
  {
    method: 'GET',
    path: '/users',
    handler: createHandler(() => {
      return getUsers()
    })
  },
  {
    method: 'POST',
    path: '/users',
    handler: createHandler(({ body }) => {
      return createUser(body)
    }),
    body: userSchema
  },
  {
    method: 'GET',
    path: '/users/:id',
    handler: createHandler(({ params }) => {
      const user = getUserById(params.id)
      if (!user) {
        return new Response(
          JSON.stringify({ error: 'User not found' }), 
          { status: 404 }
        )
      }
      return user
    })
  }
])

const server = new Server(routes)
server.use(cors())
server.use(helmet())

export default { fetch: server.fetch }

优势对比

特性	Fastify	Vafast
类型安全	⚠️ 需要额外配置	✅ 完整的 TypeScript 支持
性能	✅ 高性能	🚀 超高性能
Schema 验证	✅ JSON Schema	✅ TypeBox
中间件系统	✅ 钩子系统	✅ 灵活可扩展
路由定义	⚠️ 链式调用	✅ 配置对象
错误处理	✅ 错误处理器	✅ 中间件链
Bun 支持	❌ 需要适配	✅ 原生支持

下一步

现在您已经了解了如何从 Fastify 迁移到 Vafast，建议您：

查看快速入门开始使用 Vafast
阅读核心概念深入了解 Vafast 的工作原理
探索中间件系统了解如何扩展功能
查看示例代码获取更多实践示例

如果您在迁移过程中遇到任何问题，欢迎在我们的 GitHub Issues 社区寻求帮助。

从 Fastify 到 Vafast ​

性能 ​

Vafast

Fastify

路由 ​

主要差异 ​

1. 路由定义方式 ​

2. 请求处理 ​

3. Schema 验证 ​

4. 中间件系统 ​

5. 错误处理 ​

迁移步骤 ​

步骤 1: 安装 Vafast ​

步骤 2: 重构路由定义 ​

步骤 3: 更新 Schema 验证 ​

步骤 4: 更新中间件和钩子 ​

步骤 5: 更新错误处理 ​

完整迁移示例 ​

Fastify 应用 ​

Vafast 应用 ​

优势对比 ​

下一步 ​

从 Fastify 到 Vafast

性能

路由

主要差异

1. 路由定义方式

2. 请求处理

3. Schema 验证

4. 中间件系统

5. 错误处理

迁移步骤

步骤 1: 安装 Vafast

步骤 2: 重构路由定义

步骤 3: 更新 Schema 验证

步骤 4: 更新中间件和钩子

步骤 5: 更新错误处理

完整迁移示例

Fastify 应用

Vafast 应用

优势对比

下一步