PostgREST返回JSON的函数响应Schema随机不一致原因咨询

这种返回格式随机跳变的坑我之前踩过，也帮不少人排查过，大概率是这几个原因在搞鬼，你可以逐一核对：

• 函数返回类型动态变化
  如果你的函数内部逻辑会根据输入返回不同类型的结果——比如有时候返回SETOF集合类型（比如多条记录组成的数组），有时候返回单个ROW对象或单个JSON值，PostgREST就会自动调整返回格式：

  • 返回集合时，直接输出数组形式的原始数据；
  • 返回单个非集合类型时，就会把结果包裹在以函数名为键的对象里。
    举个实际的例子：假设你的函数是根据参数查询用户，有时候查到多条数据返回SETOF users，有时候只查到一条就返回单个users行，这时候格式自然就会跳变。

• 请求头Accept的不一致
  如果你发起请求时的Accept头不是固定的，也可能触发不同格式：

  • 当Accept: application/json时，单个对象会被函数名包裹；
  • 但如果请求头带了Accept: application/vnd.pgrst.object+json，PostgREST会直接返回单个对象，跳过函数名包裹的结构。
    要是你的客户端有时候自动加了这个自定义头，有时候没加，就会出现格式随机切换的情况。

• ?single查询参数的动态添加
  如果你在请求里有时候加了?single=true参数，有时候没加：

  • 加了这个参数时，即使函数返回的是集合类型，只要结果只有一条，PostgREST会直接返回单个对象；
  • 没加的话，哪怕只有一条结果，也会返回数组格式，不会被函数名包裹。
    如果你的请求逻辑里会动态添加这个参数，就会出现格式波动。

• PostgREST配置或函数修饰符异常
  极少数情况下，函数的稳定性修饰符（比如VOLATILE/STABLE/IMMUTABLE）如果和返回类型不匹配，或者PostgREST的db-prepared-statements配置开启后出现元数据缓存异常，也可能导致格式跳变。这种情况可以尝试重启PostgREST服务，或者检查函数的修饰符是否正确设置。

你可以先从函数的返回逻辑入手排查，看看是不是存在动态返回不同类型的情况，再核对请求头和参数的一致性，应该就能解决这个困扰了。

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