如何限制PostgREST单次查询返回的最大行数？

PostgREST 原生就支持单请求最大返回行数限制，配合你现有的Nginx反向代理做双层防护，完全可以拦住无limit的全表查询请求，不需要改业务代码。

第一层：PostgREST 原生硬限制（核心配置） #

• 核心配置项为db-max-rows，属于服务端硬限制：所有请求不管传不传limit参数、传的limit值多大，最终返回的结果行数永远不会超过你设定的阈值，从根源避免全表扫描。
• 你用官方Docker镜像部署的话，不需要改配置文件，直接加环境变量即可生效：
  • 容器启动命令直接追加参数，比如设置单请求最大返回1000行：-e PGRST_DB_MAX_ROWS=1000
  • 如果用docker-compose部署，在服务的environment段添加PGRST_DB_MAX_ROWS: 1000即可
• 阈值根据你的业务场景设置即可，公开API一般设100-1000之间足够用，不要设太大。这个配置生效后，哪怕用户故意传?limit=10000000，服务端也会自动截断到你设的最大值，不会放行全表查询。
• 有额外需求的话可以搭配数据库层的db-pre-request前置钩子做自定义权限校验，普通公开API场景只配db-max-rows就足够挡住绝大多数误操作和恶意请求。

第二层：Nginx 反向代理兜底校验 #

为了避免PostgREST配置意外失效、或者版本迭代漏配，可以在Nginx层再加一层兜底校验：

• 在转发PostgREST的location块里加参数校验规则，示例配置如下：

location / {
    # 未传limit或传非法值时，默认注入100的limit
    if ($arg_limit !~* "^[1-9][0-9]*$") {
        set $arg_limit 100;
    }
    # limit超过1000直接返回400错误
    if ($arg_limit > 1000) {
        return 400 "请求参数limit最大允许值为1000";
    }
    # 限制单请求最大响应体大小、超时时间，避免慢查询占满连接
    proxy_max_temp_file_size 10m;
    proxy_read_timeout 30s;
    proxy_pass http://127.0.0.1:3000; # 替换成你的PostgREST实际服务地址
    proxy_set_header Host $host;
}

配置生效验证 #

• 重启PostgREST和Nginx服务后，直接不带任何参数请求表接口，查看响应头的Content-Range字段，正常会显示类似0-999/1000，说明行数限制已经生效。
• 手动传大值limit比如?limit=99999测试，确认返回行数不超过设定阈值，数据库侧不会产生全表扫描的慢查询。
• 可以开1-2天数据库慢查询日志巡检，确认没有异常的全表扫请求落到数据库。

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