SuperAPI AI 工具集

supabase

编程与开发

查看项目

更新于 11-11 16:18

技能介绍

用途 该技能在任务明确涉及 Supabase 时使用,包括 Supabase 的各类产品(Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues),以及在 Next.js、React、SvelteKit、Astro、Remix 中使用 supabase-js、@supabase/ssr 等客户端库与 SSR 集成,也覆盖登录、登出等认证问题。

核心原则 Supabase 变化频繁,实施前应先获取 https://supabase.com/changelog.md 这一轻量摘要索引,扫描与任务相关的破坏性变更标签,再按链接查看具体页面,然后通过文档获取方式查阅相关主题,不要依赖训练数据中的函数签名、config.toml 设置和 API 约定。完成修复后要运行测试查询验证,未验证的修复视为不完整。若某方法失败两三次,应停止重试,改用其他方式、查文档、细看错误并检查日志。

Data API 与 RLS 新建表可能不会自动通过 Data(REST)API 暴露,此时需为 anon 和 authenticated 角色显式授权;这与 RLS 不同,RLS 控制表可访问后哪些行可见。授予公共访问时应同时启用 RLS。所有暴露 schema(默认含 public)中的表都应启用 RLS,并按实际访问模型编写策略,而非一律套用 auth.uid() 模式。

安全检查清单 认证与会话:不要在 JWT 授权判断中使用 user_metadata,因其用户可编辑,应把授权数据放在 raw_app_meta_data / app_metadata;删除用户不会使现有访问令牌失效,应先登出或撤销会话,敏感应用保持较短 JWT 有效期,严格场景可对照 auth.sessions 校验 session_id;JWT 声明在令牌刷新前不一定最新。 密钥与客户端暴露:不要在公开客户端暴露 service_role 或 secret key,前端优先使用 publishable key,旧版 anon key 仅作兼容;Next.js 中 NEXT_PUBLIC_ 环境变量会发送到浏览器。 RLS、视图与特权数据库代码:视图默认绕过 RLS,Postgres 15 及以上使用 CREATE VIEW ... WITH (security_invoker = true),旧版本可撤销 anon/authenticated 权限或放入未暴露 schema;UPDATE 需要 SELECT 策略,否则静默返回 0 行;auth.role() 已弃用,应使用 TO authenticated 或 TO anon,且 TO authenticated 仅完成认证而非授权,需在 USING 中结合所有权谓词;UPDATE 策略需同时包含 USING 和 WITH CHECK;SECURITY DEFINER 函数绕过 RLS,不要用它解决权限错误,优先 SECURITY INVOKER;public 中的 SECURITY DEFINER 函数默认对所有角色可执行,确需使用时应放在未暴露 schema、函数体内包含 auth.uid() 检查,并运行 supabase db advisors。 Storage:upsert 需要 INSERT + SELECT + UPDATE 三项权限,仅授 INSERT 会导致文件替换静默失败。依赖安全:安装 Supabase 包时应固定版本并提交锁文件。

CLI 与 MCP CLI 命令应通过 --help 逐级发现,不要猜测。已知问题:supabase db query 需 CLI v2.79.0+,supabase db advisors 需 v2.81.3+,否则改用 MCP 的 execute_sql / get_advisors 作为回退;新建迁移应先用 supabase migration new <name> 创建,不要自拟文件名。MCP 排障依次检查服务器可达性(curl 返回 401 属正常)、项目根目录 .mcp.json 配置、以及通过 OAuth 2.1 完成认证并重载会话。

文档与 schema 变更 查文档优先用 MCP search_docs,其次在文档 URL 后加 .md 获取 Markdown,再次用网络搜索。修改 schema 用 execute_sql(MCP)或 supabase db query(CLI)直接执行 SQL 以便迭代,不要用 apply_migration 改本地库;提交时先运行 advisors 修复问题、复核安全清单,再用 supabase db pull <描述名> --local --yes 生成迁移,并用 supabase migration list --local 验证。

适用场景与限制 适用于 Supabase 相关的开发、认证、数据库安全与迁移任务。使用前应针对当前官方文档核实命令、API 行为、定价、配额、凭据与部署影响,生成的示例不能替代环境特定测试、安全审查或对破坏性、高成本操作的用户批准。