SuperAPI AI 工具集

create-a-backend

编程与开发

查看项目

更新于 10-15 12:20

技能介绍

用途

该技能用于在规划、构建或迁移 API 与后端时提供架构指导,核心思路是“先选架构,再碰实现细节”,从工作负载出发而不是从编程语言出发。Vercel 不仅能跑前端,也能运行复杂的后端应用。

主要能力:产品选型对照

技能提供一张“需求—Vercel 产品”对照表:

  • HTTP API、Webhook、流式响应或框架服务端代码:Vercel Functions with Fluid compute。
  • 双向实时连接(WebSockets):Vercel Functions with Fluid compute,无需单独的实时服务。
  • 一个前端与一个或多个后端(API 端点)一起部署:Vercel Services。
  • 已有 Dockerfile、自定义运行时或系统依赖:Vercel Functions 上的容器镜像,可选与 Services 组合。
  • 带重试、休眠或外部事件的持久化多步工作:Vercel Workflows。
  • 后台任务、缓冲、扇出或直接消息路由:Vercel Queues。
  • 定时 HTTP 工作:Vercel Cron Jobs;若任务本身需要持久化,则用 Workflow。
  • Postgres、Redis、NoSQL、向量或其他应用数据:Vercel Marketplace 的存储集成。
  • 文件与用户上传:Vercel Blob。
  • 全局、读多写少的配置:Global Config。

选型建议:常规请求/响应后端用 Functions;当独立构建的组件需要共享一次部署、路由层、预览 URL 和回滚时用 Services;当组件需要独立发布周期时用独立的 Vercel 项目。受支持的框架优先使用原生 Functions 运行时;已有 Dockerfile 或需要自定义运行时、系统依赖时用容器镜像,它们以自动伸缩、无状态的 Functions 形式运行,而非常驻容器主机。后台任务、缓冲、扇出和消息路由选 Queues;持久化多步业务逻辑选 Workflow。

数据库与数据存储

通过 Marketplace 配置数据存储,凭据会被注入项目,环境保持连接。选择供应商前应查看当前目录。资料中列出的选项包括:

  • Postgres:Neon、Supabase、AWS/Aurora、Nile、Prisma
  • MySQL:AWS/Aurora
  • Redis 与键值:Upstash、Redis
  • 文档与 NoSQL:MongoDB Atlas、AWS
  • SQLite:Turso
  • 实时应用后端:Convex
  • 分析:MotherDuck

应让数据库靠近 Functions 所在区域,并使用兼容无服务器的连接或连接池。

后端框架

Vercel 为以下框架提供一等后端示例与集成:

  • Node.js 与 TypeScript:Elysia、Express、Fastify、H3、Hono、Koa、NestJS、Nitro、xmcp。当后端属于 Next.js 应用时,Next.js Route Handlers 是自然选择。
  • Python:FastAPI、Flask、Django。其他 WSGI 或 ASGI 应用在导出兼容 app 时也可运行,可能需要额外配置。
  • Go:作为 Vercel Functions 运行时受支持。

前后端组合(例如 Next.js/Vite/SvelteKit 前端搭配 FastAPI/Flask/Express/Go 后端)可通过 Services 在同一项目中一起部署。应优先使用用户已有的框架;新项目则根据生态与应用需求选择。

使用方式:工作顺序

  1. 识别同步请求、异步工作、持久数据和独立部署的组件。
  2. 从产品对照表中选择产品,然后选择框架。
  3. 加载聚焦实现的具体技能:vercel-functions、vercel-services、workflow、vercel-storage 或 marketplace。
  4. 部署前在官方文档中确认函数限制、区域、环境变量、可观测性和当前产品可用性。

适用场景与限制

适用于规划、构建或迁移 API 与后端时的架构决策,尤其是需要在 Functions、Services、容器、Workflow、Queues 等之间做选择的情况。资料未提供该技能的具体安装命令、收费方式、价格或效果数据,这些事实暂未提供。