SuperAPI AI 工具集

supabase-advanced-troubleshooting

测试与质量

查看项目

更新于 10-15 23:30

技能介绍

用途:当基础调试无法定位根因时,使用该技能对 Supabase 项目做深度 PostgreSQL 诊断,适用于慢查询、锁竞争导致超时、连接池耗尽、RLS 静默过滤、Edge Function 延迟不稳定、Realtime 订阅间歇断开等场景。

主要能力:用 pg_stat_statements 按累计执行时间、调用频率和缓存命中率排序慢查询,配合 EXPLAIN (ANALYZE, BUFFERS) 与 CREATE INDEX CONCURRENTLY 建索引;用 pg_locks 关联 pg_stat_activity 找出阻塞与被阻塞查询对,检测死锁与 idle in transaction 连接泄漏;分析 RLS 策略冲突;剖析 Edge Function 冷启动与热调用延迟;监控 Realtime 频道状态与掉线。

使用方式:需启用 pg_stat_statements 扩展,具备 SQL Editor 或 psql 直连,安装 @supabase/supabase-js v2+ 与 Supabase CLI。认证使用项目级凭据:psql 用直连串或 Supavisor 池化 URI,密码放环境变量;SDK 诊断 RPC 需 service-role key(SUPABASE_SERVICE_ROLE_KEY),从环境读取,切勿提交;CLI 先 supabase login,再 supabase link --project-ref <ref>。

限制:资料未提供具体收费、价格与效果数据;部分诊断 RPC(如 get_connection_health、get_slow_queries)需自行创建,示例仅给出骨架,完整查询集在参考文件中。