如何在REST模式下获取Supabase数据表的记录总数？

方案1：通过响应头获取（最高效，支持同时返回查询数据+总数） #

Supabase REST底层基于PostgREST，原生支持通过请求头返回计数结果，不需要拉取全量数据：

• 发起请求时新增请求头 Prefer: count=exact
• 接口响应的响应头中会返回Content-Range字段，格式为起始下标-结束下标/总记录数，斜杠后的数值就是符合查询条件的记录总数
• 该方案不需要修改原有select参数的写法，加完头之后响应体依然返回你指定的字段数据，适合分页查询时同步拿总数的场景
• 如果只需要总数不需要具体记录，可以把请求方法改成HEAD，不会返回响应体，流量消耗更低

请求示例：

curl "https://urt.to.supabase/rest/v1/table?select=field,another_field" \
  -H "apikey: 你的项目API密钥" \
  -H "Authorization: Bearer 你的项目API密钥" \
  -H "Prefer: count=exact"

如果是大表（百万级记录以上）不需要100%精确计数，可以把请求头里的count=exact替换为：

• count=planned：通过执行计划估算，性能高于精确计数
• count=estimated：通过数据库统计信息估算，性能最高，误差通常在1%以内

方案2：通过聚合查询直接在响应体返回总数 #

如果需要直接在响应体拿到计数结果，可以使用PostgREST支持的聚合语法，直接在select参数中传入count聚合：
请求示例：

# 仅返回全表总数
https://urt.to.supabase/rest/v1/table?select=my_count:count(*)

# 带过滤条件的计数，比如统计status为active的记录总数
https://urt.to.supabase/rest/v1/table?select=my_count:count(*)&status=eq.active

接口会返回格式如下的结果，直接取my_count字段即可：

[{"my_count": 256}]

注意事项 #

• 不要通过拉取全表数据后在客户端统计长度的方式获取总数，数据量较大时会产生极高的带宽和性能开销，极易触发Supabase的配额限制
• 开启RLS行级安全策略时，计数结果会自动根据当前用户的权限过滤，只会返回该用户有权限访问的记录总数

内容的提问来源于stack exchange，提问作者Diego Ulloa