Supabase自引用一对一关系为何返回数组而非对象？

我创建了profiles表，其中creator_id字段是自引用的一对一关系。由于被引用的id列具有唯一性，我期望查询返回的creator是单个对象，但实际返回结果中creator是一个对象数组。

表结构SQL #

create table public.profiles (
  id uuid not null,
  creator_id uuid not null default auth.uid (),
  first_name text not null,
  last_name text not null,
  constraint profiles_pkey primary key (id),
  constraint profiles_slug_key unique (slug),
  constraint profiles_id_key unique (id),
  constraint profiles_id_fkey foreign KEY (id) references auth.users (id) on delete CASCADE,
  constraint profiles_creator_id_fkey foreign KEY (creator_id) references profiles (id)
) TABLESPACE pg_default;

查询代码 #

const { data, error } = await supabase.from('profiles').select(
  '*, creator:profiles!creator_id(id, first_name, last_name)'
)

实际返回结果 #

{
  "id": "c2b63d53-30a9-4bca-9a41-d769e8d0a8ba",
  "first_name": "Hannah",
  "last_name": "Montana",
  "creator_id": "cd6e8ef1-2517-4f55-bfea-ba2dd81e4c55",
  "creator": [
    {
      "id": "cd6e8ef1-2517-4f55-bfea-ba2dd81e4c55",
      "last_name": "Sterner",
      "first_name": "Werner"
    }
  ]
}

原因 #

Supabase底层的PostgREST默认会把外键关联结果返回为数组，哪怕你逻辑上是一对一关系。这是因为数据库只给creator_id加了外键约束，没加唯一约束，PostgREST没法自动推断这是一对一关联，所以默认返回数组。

解决办法 #

1. 给creator_id添加唯一约束（推荐，从数据库层面保证一对一）

这一步能确保每个creator_id只能对应一条记录，彻底锁定一对一的业务规则：

ALTER TABLE public.profiles ADD CONSTRAINT profiles_creator_id_unique UNIQUE (creator_id);

2. 修改查询语句，让返回结果为单个对象

有两种写法可选：

• 用->语法直接指定一对一关联：

const { data, error } = await supabase.from('profiles').select(
  '*, creator:profiles!creator_id->(id, first_name, last_name)'
)

• 用single()强制返回单个对象（适合已加唯一约束的场景）：

const { data, error } = await supabase.from('profiles').select(
  '*, creator:profiles!creator_id(id, first_name, last_name)'
).single()

注意single()要求查询结果必须有且只有一条记录，适合明确的一对一场景。

修改后预期返回结果 #

{
  "id": "c2b63d53-30a9-4bca-9a41-d769e8d0a8ba",
  "first_name": "Hannah",
  "last_name": "Montana",
  "creator_id": "cd6e8ef1-2517-4f55-bfea-ba2dd81e4c55",
  "creator": {
    "id": "cd6e8ef1-2517-4f55-bfea-ba2dd81e4c55",
    "last_name": "Sterner",
    "first_name": "Werner"
  }
}

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