用途:从 Supabase 项目收集全面的、已脱敏的诊断信息,测试连通性、认证、Realtime、Storage、RLS 策略行为与数据库健康状况,最终打包为单个压缩包,便于提交支持工单。
主要能力:检测 SDK 版本与运行环境;测试 REST 与 Auth 端点连通性;探测数据库连接(返回 42P01 表示连接正常);检测 Realtime 订阅是否在 5 秒内进入 SUBSCRIBED;列出 Storage 桶;对比 anon 与 service_role 的可见行数以判断 RLS 是否生效;通过 Supabase CLI 收集表大小、索引使用、缓存命中、顺序扫描、长查询、膨胀与复制槽信息;获取平台状态页数据。
使用方式:需 Node.js 18+、@supabase/supabase-js v2、Supabase CLI,并设置 SUPABASE_URL 与 SUPABASE_ANON_KEY(完整诊断还需 SUPABASE_SERVICE_ROLE_KEY),CLI 命令需先执行 supabase link --project-ref <ref>。按三步执行:先采集环境与连通性,再测试 Realtime、Storage 与 RLS,最后收集数据库健康数据并打包,输出 supabase-debug-YYYYMMDD-HHMMSS.tar.gz。
限制:所有 JWT、sbp_* 项目密钥与邮箱在归档前会被自动脱敏;无 service_role 密钥时无法进行 RLS 对比;CLI 未链接时 inspect 命令不可用;Realtime 超时可能因插件未启用或配额耗尽;pg_stat_statements 未启用时相关统计不可用。未提供具体收费信息。