用途 本技能用于从零完成 Supabase 的安装与认证配置,涵盖包安装、环境变量配置、客户端初始化和连接验证,支持 TypeScript(@supabase/supabase-js)与 Python(supabase)两条路线。
前置条件 需要 Node.js 18+(JS/TS)或 Python 3.8+(Python);包管理器可使用 npm、pnpm、yarn(JS)或 pip(Python);需要一个在 Supabase Dashboard 创建的项目;仅在使用 supabase start 进行本地开发时需要 Docker Desktop。
主要能力
- 安装 SDK 与 CLI:JavaScript/TypeScript 使用 npm install @supabase/supabase-js;SSR 框架(Next.js、SvelteKit、Nuxt)额外安装 @supabase/ssr;CLI 使用 npm install -D supabase。Python 使用 pip install supabase。可通过 npx supabase --version 验证。
- 环境变量配置:在 .env.local(或 .env)中配置 SUPABASE_URL、SUPABASE_KEY(anon key,可安全用于客户端,受 RLS 约束)、SUPABASE_SERVICE_ROLE_KEY(admin key,绕过 RLS,仅限服务端)。并立即将 .env、.env.local、.env.*.local 加入 .gitignore。
- 客户端初始化与验证:使用 createClient()(而非 new SupabaseClient())创建客户端单例,包括客户端版本、服务端 admin 版本(关闭 autoRefreshToken 与 persistSession)和 Python 版本;提供连接检查代码与 PGRST116 说明。
- 可选类型生成:通过 npx supabase login、npx supabase link --project-ref、npx supabase gen types typescript --linked 生成 database.types.ts,并为客户端添加 Database 类型参数。
使用方式 按步骤执行:先安装 SDK 与 CLI,再从 Dashboard 的 Settings > API 获取凭据并写入环境变量,最后初始化客户端并运行连接验证。完整流程会产生已安装的 SDK、通过 npx supabase 可用的 CLI、包含三个键的 .env.local、客户端单例模块、服务端 admin 客户端(仅 TypeScript)以及验证过的连接。
适用场景与限制 适用于新 Supabase 项目的搭建、SDK/CLI 安装、凭据与客户端配置以及首次连通性验证。文档提供了常见错误对照表(如 FetchError、Invalid API key、PGRST301、模块未找到、CLI 未安装、Docker 未运行、错误的导入模式等)及修复方式。具体定价、配额、平台内部实现等资料未提供。