Ansible执行psql事务脚本时如何检测失败回滚并抛出部署错误

现有PostgreSQL导入脚本script.sql，通过显式事务包裹两个COPY导入逻辑：

BEGIN;
SET client_min_messages = warning;

\COPY foo_table FROM 'foo.csv' csv header DELIMITER ';';
\COPY bar_table FROM 'bar.csv' csv header DELIMITER ';';

COMMIT;

在Ansible playbook中通过community.postgresql.postgresql_db模块执行该脚本完成数据导入，任务配置如下：

- name: 'Restore SQL dump(s) on database(s)'
  become: yes
  become_user: 'postgres'
  postgresql_db:
    name: 'db'
    target: 'script.sql'
    state: 'restore'

需要实现的目标：检测事务执行失败触发回滚的场景，在部署流程中准确捕获对应错误，避免静默失败。

默认配置下任务无法捕获错误的核心原因是：postgresql_db模块的restore状态底层调用psql客户端执行脚本，而psql默认遇到错误不会终止执行，也不会返回非0退出码。如果事务内任意语句（比如\COPY因为文件不存在、字段不匹配、约束冲突报错）执行失败，PostgreSQL会将事务标记为abort状态，后续所有语句（包括末尾的COMMIT）都会被跳过，最终事务自动回滚，但psql依然会返回0退出码，导致Ansible误判任务执行成功，出现静默失败。

1. 开启psql的错误即终止配置（必选） #

在postgresql_db模块配置中添加extra_args参数，传入psql的启动参数，开启ON_ERROR_STOP变量。开启后psql遇到任何错误（包括SQL错误、\COPY这类元命令错误）都会立刻终止执行，并返回非0退出码，Ansible会直接将任务标记为失败，自动触发playbook的错误处理逻辑，同时PostgreSQL会因为连接断开自动回滚未提交的事务，不会产生脏数据。
修改后的任务配置示例：

- name: 'Restore SQL dump(s) on database(s)'
  become: yes
  become_user: 'postgres'
  postgresql_db:
    name: 'db'
    target: 'script.sql'
    state: 'restore'
    extra_args: '-v ON_ERROR_STOP=1'

2. 优化SQL脚本的错误日志配置（建议） #

脚本中SET client_min_messages = warning;会屏蔽NOTICE、INFO级别的日志，虽然不会屏蔽ERROR级别的报错，但导入场景下建议移除该配置，使用默认的日志级别，避免关键排查信息被吞，方便出错时快速定位原因。

3. 可选：增加导入后校验（高可靠场景可选） #

如果对数据一致性要求极高，可以在导入任务后增加校验步骤，例如查询导入表的记录数、校验核心字段的取值范围，和CSV文件的预期数据做对比，进一步规避极端场景下的异常：

- name: Verify imported row count
  postgresql_query:
    db: db
    query: 'SELECT count(*) as cnt FROM foo_table'
  register: foo_count
  failed_when: foo_count.query_result[0].cnt != 预期foo表行数

注意：ON_ERROR_STOP对psql元命令（比如示例中的\COPY）的错误同样生效，不需要额外做特殊适配。

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