できない.dev

PostgreSQL「current transaction is aborted」の原因と直し方

current transaction is aborted は、ROLLBACK してやり直すか、失敗しうる文を SAVEPOINT で囲めば直る。
同じトランザクションで先に失敗した SQL があると、後の文はすべてこのエラーで拒まれる。

公開: 更新:

症状できない
psql -U postgres -a -f aborted.sql
…
psql:aborted.sql:3: ERROR:  duplicate key value violates unique constraint "users_email_key"
DETAIL:  Key (email)=(a@example.com) already exists.
SELECT count(*) FROM users;
psql:aborted.sql:4: ERROR:  current transaction is aborted, commands ignored until end of transaction block

2026-11-20 に postgres:17(PostgreSQL 17.12) で実際に打って取った出力。検証環境の詳細

要約

PostgreSQL のトランザクションの途中で 1 文が失敗すると、以降の文がすべて次のエラーになる。

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

current transaction is aborted は、同じトランザクションの中で前の SQL がすでに失敗していることを知らせるエラーである。
このエラーそのものに原因は無く、最初に失敗した SQL を直し、ROLLBACK してからやり直せば直る。
失敗してもよい文があるなら、その文を SAVEPOINT で囲む。
SQLSTATE は 25P02(in_failed_sql_transaction)である。

実行例

postgres:17 で UNIQUE 違反のあとに SELECT を送ると、「current transaction is aborted」で拒まれ、COMMIT は ROLLBACK になった。
この間も psql -f の終了コードは 0 だった。
SAVEPOINT で囲むと、1 つ目の行は COMMIT で残った。

$ psql -U postgres -a -f aborted.sql
BEGIN;
BEGIN
INSERT INTO users VALUES (1, 'a@example.com');
INSERT 0 1
INSERT INTO users VALUES (2, 'a@example.com');
psql:aborted.sql:3: ERROR:  duplicate key value violates unique constraint "users_email_key"
DETAIL:  Key (email)=(a@example.com) already exists.
SELECT count(*) FROM users;
psql:aborted.sql:4: ERROR:  current transaction is aborted, commands ignored until end of transaction block
COMMIT;
ROLLBACK
$ echo $?
0
$ psql -U postgres -a -f rollback.sql
SELECT count(*) FROM users;
 count 
-------
     0
(1 row)
$ psql -U postgres -a -f savepoint.sql
BEGIN;
BEGIN
INSERT INTO users VALUES (1, 'a@example.com');
INSERT 0 1
SAVEPOINT sp1;
SAVEPOINT
INSERT INTO users VALUES (2, 'a@example.com');
psql:savepoint.sql:4: ERROR:  duplicate key value violates unique constraint "users_email_key"
DETAIL:  Key (email)=(a@example.com) already exists.
ROLLBACK TO SAVEPOINT sp1;
ROLLBACK
COMMIT;
COMMIT
SELECT id, email FROM users;
 id |     email     
----+---------------
  1 | a@example.com
(1 row)

— 2026-11-20 時点の出力

検証環境PostgreSQL 17.12 / 2026-11-20 検証
検証日
実行環境
postgres:17 Debian GNU/Linux 13 (trixie)
バージョン
  • PostgreSQL 17.12

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 最初のエラーを直して ROLLBACK する

psql なら、ログを上へたどって最初の ERROR を直し、ROLLBACK; を打ってからやり直す。
中断したトランザクションは ROLLBACK か COMMIT で終えるまで、どの SQL も受け付けない。

2. アプリでは例外のあとに rollback() を呼ぶ

try:
    cur.execute("INSERT INTO users VALUES (2, 'a@example.com')")
except psycopg.errors.UniqueViolation:
    conn.rollback()
cur.execute("SELECT count(*) FROM users")

conn.rollback() を呼んだあとの SELECT は通った。
ただし、そのトランザクションで先に入れた行も取り消される。

3. 失敗しうる文だけを SAVEPOINT で囲む

BEGIN;
INSERT INTO users VALUES (1, 'a@example.com');
SAVEPOINT sp1;
INSERT INTO users VALUES (2, 'a@example.com');
ROLLBACK TO SAVEPOINT sp1;
COMMIT;

2 つ目の INSERT が失敗しても、ROLLBACK TO SAVEPOINT で中断が解けて、1 つ目の行は COMMIT で残った(SAVEPOINT(新しいタブで開く))。
psycopg 3 の with conn.transaction(): は、すでにトランザクションが開いているときに使うと SAVEPOINT になる。
中で出た例外はブロックの外へ出るので、try と except で受けてから commit() すると、ブロックより前に入れた行は残った。
トランザクションが開いていないときに使うと、SAVEPOINT ではなく新しいトランザクションになる(psycopg のトランザクション(新しいタブで開く))。

psql で手作業をするときは、\set ON_ERROR_ROLLBACK on を打っておくと、psql が文ごとに SAVEPOINT を張る(psql(新しいタブで開く))。
失敗した INSERT だけが取り消され、後の文と COMMIT はそのまま通った。

よくある原因

  1. 前の SQL が失敗している。
    PostgreSQL は、トランザクションの途中で 1 文でも失敗すると、ROLLBACK されるまで後の文をすべて拒む。
    PostgreSQL 17.11 の公式イメージで、BEGIN のあとに UNIQUE 制約に当たる INSERT を打つと、続く SELECT がこのエラーになった。
    この状態で COMMIT を打つと、応答は ROLLBACK になり、失敗より前に成功した INSERT も残らなかった。
  2. アプリが例外を握りつぶしている。
    psycopg など Python の DB-API ドライバは既定で暗黙に BEGIN を送るので、アプリが明示しなくてもトランザクションは開いている。
    psycopg 3.3.8 で UniqueViolation を except で捕まえたあと、同じ接続で SELECT を送ると psycopg.errors.InFailedSqlTransaction になった。
  3. 失敗してよい文を囲んでいない。
    「入れてみて重複なら無視する」処理を SAVEPOINT なしで書くと、重複したときにトランザクション全体が使えなくなる。

ログにこのエラーが何行も並んでいるときは、いちばん上の ERROR が本当の原因である。