supabase

supabase 快速入门

用最像 SQL 的方式,在 5 分钟内搭好一个带认证、数据库和实时功能的全栈后端。

这是什么?解决什么问题?

Supabase 被称为”开源的 Firebase 替代品”,本质是把 PostgreSQL、Auth、Storage、Realtime、Edge Functions 打包成一套开箱即用的 BaaS(后端即服务)。对前端开发者来说,过去要花一两天搭的”用户注册 + 数据表 + 权限控制”组合,现在只要 10 分钟就能跑起来。 supabase Skill 是 Supabase 官方维护的 MCP Server,它把 Supabase 的所有能力(建表、查数据、跑迁移、调用 Edge Function、上传文件、查日志)暴露成 AI 助手可以直接调用的工具集。当你在 Claude Code 或 Cursor 里加载这个 Skill 后,AI 不仅能”写”SQL,还能真的去执行迁移、读取数据、生成 TypeScript 类型。 它解决的核心痛点是:新手往往不知道 Supabase 的 RLS(行级安全)策略怎么写、迁移文件怎么组织、Realtime 频道怎么订阅。这个 Skill 把这些”最佳实践”内化进 AI 的回答里,降低踩坑概率。适合独立开发者快速原型验证、小团队做 MVP、教育场景教学演示。

准备工作

1. Node.js 18+ 或 Python 3.10+ 任一环境
2. Supabase 账号:免费注册 https://supabase.com/dashboard
3. Claude Code / Cursor / Cline 等支持 MCP 的 AI 客户端
4. 可选:supabase CLI(本地开发、跑迁移必备):https://github.com/supabase/cli

3 步快速上手

第 1 步:安装 Skill(以 Claude Code 为例)

通过 MCP 协议加载:

claude mcp add --transport http supabase https://mcp.supabase.com/mcp

如果是 Cursor,在 .cursor/mcp.json 写入:

{
"mcpServers": {
"supabase": {
"url": "https://mcp.supabase.com/mcp"
}
}
}

第 2 步:验证安装

打开 AI 客户端,执行:

请列出当前 supabase 项目下所有的表

如果返回了真实表名(或空表列表),说明 MCP 已连通。

第 3 步:用 Skill 建一张表

对 AI 说:

用 supabase Skill,帮我在 todos 表里添加一个 is_done 字段,类型 boolean,默认 false

AI 会自动生成并执行 SQL 迁移,而不是只给你一段代码。这是 Supabase MCP 区别于普通文档 Skill 的最大优势。

常见踩坑

1. RLS 没开启导致数据裸奔:新建表后,Supabase 默认 关闭 RLS,任何带 anon key 的请求都能读全部数据。新表上线前必须 ALTER TABLE x ENABLE ROW LEVEL SECURITY;。
2. anon key 和 service_role key 混用:前端代码里只能用 anon key(安全可控的、受 RLS 约束),service_role key 拥有上帝权限,只能放在后端环境变量里,绝不能进前端 bundle。
3. 迁移文件冲突:多人协作时如果都用 mcp 跑迁移,会出现迁移序号冲突。团队协作建议在本地用 supabase migration new 走 Git 流程,再统一 supabase db push。
4. Realtime 订阅性能问题:默认 Realtime 走的是 WebSocket 长连接,单表订阅超过 1000 行/秒会触发限流。大量场景建议改用 Postgres CDC + 自建后端消费。
5. Edge Function 冷启动:Deno 部署,首次调用延迟可能在 200-500ms,实时性要求高的接口建议提前预热。
6. TypeScript 类型不会自动同步:如果只用 MCP 改表,前端 supabase-js 的类型不会更新,需要 supabase gen types typescript 重新生成。

初级用法

1. Auth 接入:在前端用 supabase.auth.signUp({ email, password }) 注册,supabase.auth.signInWithPassword 登录,session 自动存到 localStorage。
2. CRUD 一行搞定:supabase.from('todos').select('*') 查、insert 增、update 改、delete 删,语法接近 SQL。
3. Storage 上传:supabase.storage.from('avatars').upload('user1/avatar.png', file),配合公开桶或签名 URL 即可访问。

高级玩法

1. Postgres 触发器 + Edge Functions:数据库事件触发 serverless 函数,例如”用户注册后自动发欢迎邮件”,无需写后端服务。
2. 向量搜索(pgvector):Supabase 自带 pgvector 扩展,可以直接存 embedding 做语义检索,适合做 RAG 应用。
3. 跨项目复制:在 Supabase Dashboard 启用 Logical Replication,把生产库的数据镜像到本地或另一个区域做灾备。

小技巧

• 在 SQL 编辑器里用 explain analyze 看查询计划,慢查询一般都能从索引上找原因。
• 免费版项目闲置 7 天会暂停,长期 demo 项目建议用 cron 定时 ping 一下。
• 启用 auto_increment 字段建议用 bigint generated by default as identity,比老的 serial 类型更标准。
• 跑迁移前先在本地 supabase db reset 验证一次,避免直接污染生产。
• 调试 RLS 策略时,可以用 set role anon; 切换到匿名用户身份执行 SQL,模拟前端请求。

参考链接

• Skill(MCP Server)仓库
• Supabase 官方文档
• Supabase JavaScript 客户端
• RLS 策略示例
• Supabase CLI 工具