Postgres14插入tag表时关联插入team_member_tag表报错求助

错误原因 #

你遇到的more than one row returned by a subquery used as an expression错误，是因为用来获取tag_id的子查询返回了多行结果，但PostgreSQL要求用作表达式的子查询必须返回恰好一行。比如类似下面的写法就会触发这个错误：

INSERT INTO team_member_tag (team_member_id, tag_id)
VALUES (123, (SELECT id FROM tag WHERE name = 'new_tag'));

如果tag表中存在多个name为new_tag的记录，子查询就会返回多行，导致报错。

正确解决方案 #

利用PostgreSQL的WITH子句（公共表表达式）结合RETURNING关键字，先插入tag表并获取自动生成的id，再用这个ID插入关联的team_member_tag表。这种方式既能保证操作的原子性（要么全成功，要么全回滚），又能彻底避免子查询返回多行的问题。

场景1：插入单个Tag，关联多个Team Member #

WITH inserted_tag AS (
  INSERT INTO tag (team_id, name)
  VALUES (1, '技术部')  -- 替换为你的实际team_id和tag名称
  RETURNING id AS tag_id
)
INSERT INTO team_member_tag (team_member_id, tag_id)
SELECT tm.id, it.tag_id
FROM (
  VALUES (101), (102), (103)  -- 替换为需要关联的team_member_id列表
) AS tm(id)
CROSS JOIN inserted_tag it;

场景2：批量插入多个Tag，分别关联对应Team Member #

如果需要一次性插入多个Tag并各自关联对应的成员，可以用以下写法：

WITH inserted_tags AS (
  INSERT INTO tag (team_id, name)
  VALUES 
    (1, '技术部'),
    (1, '产品部'),
    (2, '运营部')
  RETURNING id AS tag_id, name AS tag_name
)
INSERT INTO team_member_tag (team_member_id, tag_id)
SELECT 
  tm.team_member_id,
  it.tag_id
FROM (
  VALUES 
    (101, '技术部'),
    (102, '技术部'),
    (103, '产品部'),
    (104, '运营部')
) AS tm(team_member_id, tag_name)
JOIN inserted_tags it ON tm.tag_name = it.tag_name;

额外建议 #

为了避免后续再出现类似问题，建议给tag表添加唯一约束，确保同一个团队下的Tag名称唯一：

ALTER TABLE tag ADD CONSTRAINT uq_tag_team_name UNIQUE (team_id, name);

这样不仅能防止重复插入同名Tag，还能保证后续查询tag_id的子查询只会返回一行结果。

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