Supabase最佳实践，分级诊断慢查询和RLS-Claw龙虾部署大师-有用科技官网

「Supabase Postgres 最佳实践」是「龙虾部署大师」技能市场中的数据库诊断优化技能：作用是先收集诊断数据、再按问题类型选择工作流，定位慢查询、缺失索引、连接过多和 RLS 性能问题，并给出可用 EXPLAIN 验证的 SQL 修改、索引方案、连接池配置和监控建议，把"凭经验猜"换成"按证据查"。

技能效果

面对一条大表上很慢的 Supabase 查询时，它先讲清没索引时会全表扫描加排序，再给出该建的复合索引和优化后执行计划会怎么变。

Supabase Postgres技能对话示例：慢查询诊断与索引优化方案

Supabase 数据库变慢，常见症状有哪些

Supabase 上的 Postgres 性能问题往往以几种典型症状出现：接口超时、查询慢得离谱，多半是慢查询或缺了索引；频繁报 Too many connections，通常是连接池配置或连接泄漏；开了行级安全（RLS）之后接口突然变慢，问题常在策略函数的写法和它能不能用上索引；还有表数据量涨上来后，没有合适的复合索引或分区，查询逐渐拖垮。这些症状有时单独出现，有时几个叠在一起，单靠肉眼看 SQL 很难判断根因。

这个技能能帮你诊断和改什么

它的工作方式是"先取证、再开方"：要求先读取相关规则、收集诊断数据，再按 Too many connections、慢查询、RLS 变慢、连接池配置或多症状这几类问题选择对应的工作流或参考规则，通过必要的门禁查询后才给建议，避免凭经验误判。覆盖的诊断维度包括查询性能、连接管理、安全 RLS 和 Schema 设计，可以定位慢查询的成因、缺失的索引、连接耗尽、RLS 策略的性能开销，并给出复合索引、部分索引、分区方案、权限检查和连接池配置。关键是每条修改建议都配 EXPLAIN 验证步骤，让你能确认改动真的生效。

把"先收集证据再下结论"做成强制门禁，正是这套实践和随手调优的区别：数据库性能问题最忌猜，EXPLAIN 验证保证给出的索引或改写确实改善了执行计划，而不是看起来合理。

用前须知

核心指南无需密钥即可参考；其中的诊断脚本（如 pg_diagnose）需要 Python 与数据库连接串才能运行。连接 Supabase 或 Postgres 实例时，应使用只读或受控权限，并妥善保护连接凭据，避免在诊断过程中误改生产数据。

怎么用它

用法是把数据库当前的症状用自然语言描述给它，由它按流程取证、定位并给出可验证的方案。例如可以这样对它说：

可以这样对它说

"Supabase 查询老超时，先跑诊断，再看是不是缺索引、执行计划哪里有问题。"
"开了 RLS 之后接口变慢，检查一下策略写法、函数调用和过滤成本。"
"连接数经常爆掉，按连接池和慢查询一起排查 Postgres 的瓶颈。"

它适合这些场景：Supabase 项目出现慢查询、超时或 Too many connections 错误；启用 RLS 后接口变慢、需要检查策略函数和索引使用；表增长后要设计复合索引、部分索引或分区策略；上线前要审查 SQL、权限、连接池和监控配置是否安全。适合 Supabase 开发者、后端工程师、数据库管理员、全栈团队，以及要优化 Postgres 性能与安全策略的技术负责人。