直接用 RETURNING id，这是最可靠、原子性最强的方式；需确保列名与表定义一致，且在客户端正确获取返回结果集，避免忽略 fetch 或仅取首行导致漏数据。
PostgreSQL INSERT后怎么拿到刚插入的自增ID
直接用 RETURNING，这是最可靠、原子性最强的方式。别查 LASTVAL() 或 CURRVAL()，它们在并发场景下可能返回错误值，也不适用于多行插入。
RETURNING子句的基本写法和常见错误
语法很简单：在 INSERT 语句末尾加 RETURNING column_name。但容易出错的地方不少：
- 忘记写列名——
RETURNING *可以用，但不推荐；显式写RETURNING id更清晰、更安全 - 对没有主键或序列的表误用——确保目标列是
SERIAL、GENERATED ALWAYS AS IDENTITY或带默认序列的列 - 在客户端里忽略返回结果集——比如用
pg_query()（PHP）或cursor.execute()（Python）时没调用fetchone()或类似方法取回值 - 多行插入时只写
RETURNING id，结果会返回多行——这本身不是错，但若代码只取第一行就漏数据
不同主键定义方式下RETURNING是否都有效
只要插入成功并生成了新值，RETURNING 就能取到。但要注意底层机制差异：
-
SERIAL列：本质是INTEGER DEFAULT nextval('table_id_seq')，RETURNING没问题 -
GENERATED ALWAYS AS IDENTITY：标准 SQL 方式，RETURNING同样适用，且更推荐用于新表 - 手动指定
nextval()：比如INSERT INTO t (id, name) VALUES (nextval('t_id_seq'), 'x') RETURNING id——也能用，但没必要绕路 - UUID 主键（如
gen_random_uuid()）：同样支持RETURNING id，只要该列在插入时被赋值
Python psycopg2 和 Node.js pg 中的实际调用要点
不同驱动对 RETURNING 的处理逻辑一致，但 API 调用姿势有细节差别：
- psycopg2：必须用
cursor.execute(sql, params)+cursor.fetchone()（单行）或cursor.fetchall()（多行）。不能只用cursor.execute()就以为完事 - Node.js pg：用
client.query()，结果在res.rows[0].id（单行）或res.rows.map(r => r.id)（多行）。注意不要漏 await - 如果插入语句带 CTE（WITH 子句），
RETURNING依然可用，但要放在最外层 INSERT 后，不能放在 WITH 里
复杂点在于批量插入时返回多个 ID 的处理逻辑，以及事务中嵌套操作时是否需要显式绑定结果变量——这些地方最容易被当成“简单功能”而忽略健壮性设计。
