如何将自定义复合类型数组插入PostgreSQL的复合类型数组列？

API 探路者

2026-6-18

解决方案

核心问题在于：json_populate_recordset返回的是多行复合类型记录，而你需要的是单个复合类型数组值，必须把返回的行集聚合为数组，才能插入到address[]列实现单行插入。

先对齐基础结构（以常见场景为例）

假设你的自定义类型和表结构如下：

-- 自定义复合类型
CREATE TYPE address AS (
    street TEXT,
    city TEXT,
    zip_code TEXT
);

-- 目标表
CREATE TABLE user_addresses (
    id SERIAL PRIMARY KEY,
    addresses address[] -- 你要插入的数组列
);

正确的插入方式

方法1：`json_populate_recordset` + `array_agg`聚合（推荐，通用）

这是最灵活的方式，无需手动对应字段：

INSERT INTO user_addresses (addresses)
SELECT array_agg(addr)
FROM json_populate_recordset(null::address, $1) AS addr;

$1就是你用JSON.stringify(customers)生成的JSON数组字符串（格式类似[{"street":"...","city":"...",...},...]）
json_populate_recordset将JSON数组的每个对象转为address类型的行，再通过array_agg把这些行打包成address[]数组，最终插入单行数据。

方法2：手动解析JSON字段构造数组（适合字段少的场景）

如果不想用聚合函数，也可以手动提取JSON字段构造复合类型，再组装成数组：

INSERT INTO user_addresses (addresses)
SELECT ARRAY(
    SELECT (j->>'street', j->>'city', j->>'zip_code')::address
    FROM jsonb_array_elements($1::jsonb) AS j
);

这种方式需要明确写出复合类型的所有字段，适合字段固定且数量少的场景。