PostgreSQL『current transaction is aborted, commands ignored until end of transaction block』エラーの原因と対処

ERROR:  current transaction is aborted, commands ignored until end of transaction block

-- 1) いったんトランザクションを捨てる
ROLLBACK;

-- 2) 必要ならやり直す（原因を除去してから）
BEGIN;
...（安全なSQL）...
COMMIT;

\errverbose               -- 直前エラーの詳細（psql）
\set VERBOSITY verbose    -- 以降のエラーを詳細表示

DROP TABLE IF EXISTS u;
CREATE TABLE u(id int PRIMARY KEY, name text);

BEGIN;
INSERT INTO u VALUES (1,'ok');
INSERT INTO u VALUES (1,'dup');   -- ここで 23505 UNIQUE VIOLATION（失敗）
SELECT count(*) FROM u;           -- ← 以降は 25P02: current transaction is aborted
ROLLBACK;                         -- これで解除

BEGIN;
SAVEPOINT sp1;
INSERT INTO u VALUES (1,'try');       -- 失敗があり得る操作
-- 失敗したら
ROLLBACK TO SAVEPOINT sp1;            -- Tx全体は維持
-- 続行可能
INSERT INTO u VALUES (2,'ok');
COMMIT;

\set ON_ERROR_STOP on          -- 最初のエラーでスクリプト中断（原因追跡向け）
\set ON_ERROR_ROLLBACK on     -- 対話時、各文ごとにSAVEPOINTで自動復旧（BEGIN中）
\set VERBOSITY verbose
\errverbose

import psycopg
with psycopg.connect(dsn) as conn:
    with conn.cursor() as cur:
        try:
            cur.execute("BEGIN")
            cur.execute("INSERT INTO u VALUES (1,'x')")
            cur.execute("INSERT INTO u VALUES (1,'dup')")  # ここで例外
            cur.execute("SELECT count(*) FROM u")          # 到達不可：25P02
            cur.execute("COMMIT")
        except Exception:
            cur.execute("ROLLBACK")  # 失敗Txを即終了
            # もしくは SAVEPOINT を使うなら:
            cur.execute("BEGIN")
            cur.execute("SAVEPOINT sp")
            try:
                cur.execute("INSERT INTO u VALUES (1,'dup')")
            except Exception:
                cur.execute("ROLLBACK TO SAVEPOINT sp")
            cur.execute("COMMIT")

// 自動コミットがfalseなら、エラー後は必ず rollback() する
conn.setAutoCommit(false);
try (PreparedStatement ps = conn.prepareStatement("INSERT INTO u VALUES (?,?)")) {
  ps.setInt(1, 1); ps.setString(2, "dup");
  ps.executeUpdate();                    // ここで例外→以後は25P02相当
  conn.commit();                         // 到達しない
} catch (SQLException e) {
  conn.rollback();                       // 直ちに失敗Txを終了
}

// SAVEPOINTパターン
conn.setAutoCommit(false);
Savepoint sp = conn.setSavepoint("sp1");
try {
  // 危険操作
  try (Statement st = conn.createStatement()) {
    st.executeUpdate("INSERT INTO u VALUES (1,'dup')");
  }
} catch (SQLException e) {
  conn.rollback(sp);                     // 部分ロールバック
}
conn.commit();

const { Client } = require('pg');
const client = new Client({ connectionString: process.env.DSN });
await client.connect();

try {
  await client.query('BEGIN');
  await client.query('INSERT INTO u VALUES ($1,$2)', [1,'ok']);
  await client.query('INSERT INTO u VALUES ($1,$2)', [1,'dup']); // ここで失敗
  await client.query('COMMIT');                                   // 到達せず
} catch (e) {
  await client.query('ROLLBACK');  // すぐ終わらせる
}

// SAVEPOINT例
await client.query('BEGIN');
await client.query('SAVEPOINT sp');
try {
  await client.query('INSERT INTO u VALUES ($1,$2)', [1,'dup']);
} catch {
  await client.query('ROLLBACK TO SAVEPOINT sp');
}
await client.query('COMMIT');

SELECT pid, usename, state, query, xact_start
FROM pg_stat_activity
WHERE pid = pg_backend_pid();
-- state が 'idle in transaction (aborted)' なら、ROLLBACKが必要

-- 競合時に更新（または何もしない）でエラーを出さない
INSERT INTO u(id, name) VALUES (1,'alice')
ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name;

INSERT INTO u(id, name) VALUES (1,'bob')
ON CONFLICT (id) DO NOTHING;

-- スクリプト先頭で安全網
\set ON_ERROR_STOP on
\set ON_ERROR_ROLLBACK on
\set VERBOSITY verbose

-- 冪等DDL（存在チェックで「失敗」を避ける）
CREATE TABLE IF NOT EXISTS u(id int PRIMARY KEY, name text);
ALTER TABLE u ADD COLUMN IF NOT EXISTS note text;

DROP TABLE IF EXISTS u;
CREATE TABLE u(id int PRIMARY KEY, name text);

BEGIN;
INSERT INTO u VALUES (1,'ok');

SAVEPOINT sp;                            -- 危険区間の前
INSERT INTO u VALUES (1,'dup');          -- ここで失敗
-- ERROR発生後はTxがaborted、以降のコマンドは拒否される
-- ただし SAVEPOINT があるので：
ROLLBACK TO SAVEPOINT sp;                -- 部分回復（Txは継続）
INSERT INTO u VALUES (2,'next');         -- 続行できる
COMMIT;