Vercel + Supabase 部署教程
适用:前端托管在 Vercel,后端/数据库使用 Supabase
准备
- 前端代码:静态站或 Next.js 应用,代码托管在 GitHub。
- Supabase 项目:在 Supabase Dashboard 创建项目,获取
SUPABASE_URL 与 SUPABASE_ANON_KEY/SERVICE_ROLE_KEY。
前端部署(Vercel)
- 在 Vercel 导入 GitHub 仓库,保持默认构建设置。
- 在 “Settings → Environment Variables” 添加:
SUPABASE_URL
SUPABASE_ANON_KEY(前端公开调用)
- 重新部署,页面可通过 Supabase JS SDK 访问数据库。
Next.js:可在 .env.local 中定义,再由 Vercel 自动注入。
后端 / API 选项
- 仅前端 + Supabase:使用 Supabase Auth / DB / Storage / Functions,前端直接调用。
- Next.js Route Handlers:在
app/api/* 中编写 API,使用 SUPABASE_SERVICE_ROLE_KEY(仅在服务端环境变量)。
- 边缘/无服务器函数:Vercel Edge/Serverless Functions 内读取 Supabase 环境变量,避免暴露密钥。
常见问题
- 客户端暴露密钥:前端只能用
ANON_KEY;服务端场景用 SERVICE_ROLE_KEY 并放在 Serverless 环境变量。
- CORS / 网络失败:检查 Supabase 项目设置中允许的域名;国内访问可考虑加速或代理。
- 构建失败:确认
.env 已配置,或在 Vercel 环境变量界面补齐。