PostgreSQL中INSERT...RETURNING是否保证返回行与输入顺序一致？

核心结论 #

PostgreSQL 的 INSERT...RETURNING 语句返回的行，与单条 INSERT 语句中 VALUES 子句的输入顺序完全一致——这是 PostgreSQL 长期稳定的行为，尽管官方文档未明确标注，但已是社区公认的事实，也是很多批量插入工具的依赖基础。

具体细节 #

• PostgreSQL 自身行为：当执行单条多行插入（如 INSERT INTO authors (name) VALUES ('Alice'), ('Bob'), ('Charlie') RETURNING id;）时，数据库会按 VALUES 列表的顺序依次处理每条记录，RETURNING 子句也会按相同顺序返回生成的 ID（或其他字段）。即使是通过 INSERT ... SELECT ... ORDER BY 形式插入，返回顺序也会遵循 SELECT 语句的 ORDER BY 规则。
• Rails import 包的实现逻辑：该包确实依赖 PostgreSQL 的这一特性。批量导入 Author 时，通过 INSERT...RETURNING 获取按输入顺序排列的 ID 列表，直接将这些 ID 对应到待插入的 Book 记录的 author_id 字段中，再执行 Book 的批量插入，无需额外的映射或关联查询来匹配数据。

注意事项 #

• 仅保证单条 INSERT 语句内的返回顺序与输入一致；如果是多条独立的 INSERT 语句并发执行，不同语句的返回结果顺序无法保证。
• 若插入时使用了 ON CONFLICT 子句处理冲突，被跳过或更新的记录也会按原输入顺序出现在返回结果中（取决于 RETURNING 配置）。

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