SuperAPI AI 工具集

vercel-hello-world

编程与开发

查看项目

更新于 10-15 23:30

技能介绍

用途:在 Vercel 上部署一个最小项目,包含静态页面和 /api/hello 无服务器 API 路由,用于验证 CLI 认证、项目结构与部署流水线是否端到端正常。

前提:已完成 vercel-install-auth 设置,已安装并认证 Vercel CLI,Node.js 18+。

主要步骤:

  1. 创建项目结构:mkdir my-vercel-app && cd my-vercel-app,然后 npm init -y;在 public/index.html 放置静态页面,通过 fetch('/api/hello') 获取 JSON。
  2. 创建 API 路由 api/hello.ts,使用 @vercel/node 的 VercelRequest/VercelResponse,返回 message、timestamp、region;安装依赖:npm install --save-dev @vercel/node typescript。
  3. 添加 vercel.json,配置 rewrites 与 /api/(.*) 的 Cache-Control 头。
  4. 部署预览:vercel;测试:curl 静态页与 /api/hello。
  5. 生产部署:vercel --prod,或 vercel promote <预览URL>。

运行时可用系统环境变量包括 VERCEL、VERCEL_ENV、VERCEL_URL、VERCEL_REGION、VERCEL_GIT_COMMIT_SHA、VERCEL_GIT_COMMIT_MESSAGE。

常见错误:/api/hello 返回 404 通常是文件未放在 api/ 目录;FUNCTION_INVOCATION_FAILED 需查看 vercel logs;BUILD_FAILED 可先本地运行 npx tsc --noEmit;响应体超过 4.5 MB 会报 FUNCTION_PAYLOAD_TOO_LARGE。

限制:资料未提供收费、价格、平台支持范围等细节;示例建议先在预览环境验证,不要将未审核的 hello-world 部署指向客户域名。