PostgreSQL duplicate keyの直し方｜シーケンスのずれ

ERROR: duplicate key value violates unique constraint "customer_pkey" は、すでにある値と同じ値を、重複が許されない列（主キー・UNIQUE）に入れようとしたときのエラーです。 制約の名前が _pkey（主キー）で、id を指定せずに INSERT しているのに出るなら、ほぼ確実にシーケンス（自動採番）が、テーブルの中の最大の id より後ろに戻っているのが原因です。

確認環境：PostgreSQL 16.15（確認日 2026年10月11日）。serial 列と IDENTITY 列（ALWAYS・BY DEFAULT）、\copy での取り込みで再現しました。

再現：id を指定して入れたあと、通常の INSERT が失敗する

CREATE TABLE customer (id serial PRIMARY KEY, email text UNIQUE, name text);

INSERT INTO customer (name, email) VALUES ('佐藤', 'sato@example.com'), ('鈴木', 'suzuki@example.com');   -- id 1, 2
-- データ移行：id を指定して入れる
INSERT INTO customer (id, name, email) VALUES (3, '高橋', '...'), (4, '田中', '...'), (5, '伊藤', '...');

INSERT INTO customer (name, email) VALUES ('渡辺', 'watanabe@example.com');   -- 通常の INSERT

ERROR:  duplicate key value violates unique constraint "customer_pkey"
DETAIL:  Key (id)=(3) already exists.

id を指定した INSERT では、シーケンスは進みません。 シーケンスは「次は 3」のままなので、3・4・5 とぶつかり続けます。

失敗しても番号は進む（何回かやると通ってしまう）

もう一度 INSERT すると、今度は Key (id)=(4) already exists. になりました。失敗した INSERT でも、シーケンスの番号は使われて進みます（PostgreSQL 公式ドキュメントでも、nextval で取った値は取り消されないとされています）。3 回失敗すると 6 に届いて通るため、「何度か実行したら直った」と見えますが、原因は残っています。

直し方：setval でシーケンスを最大値に合わせる

SELECT setval(pg_get_serial_sequence('customer', 'id'),
              coalesce(max(id), 1),
              max(id) IS NOT NULL)
FROM customer;

 setval
--------
      5

INSERT INTO customer (name, email) VALUES ('渡辺', 'watanabe@example.com') RETURNING id;
 id
----
  6                ← 最大値の次から採番された

確認環境でも、空のテーブルにこの SQL を実行すると、次の id は 1、データがあれば最大値の次になりました。PostgreSQL 公式ドキュメントのとおり、3つ目の引数が true なら「次は指定値＋1」、false なら「次は指定値そのもの」です。

setval はトランザクションを ROLLBACK しても元に戻りません（公式ドキュメント）。本番で実行する前に、max(id) を確かめてから実行します。

データベースの全テーブルをまとめて直す

移行のあとは、ほかのテーブルもずれています。public スキーマの、シーケンスを持つ列をすべて直す例です。

DO $$
DECLARE r record; m bigint;
BEGIN
  FOR r IN
    SELECT c.relname AS t, a.attname AS col,
           pg_get_serial_sequence(quote_ident(c.relname), a.attname) AS seq
    FROM pg_class c JOIN pg_attribute a ON a.attrelid = c.oid
    WHERE c.relkind = 'r' AND c.relnamespace = 'public'::regnamespace AND a.attnum > 0
      AND pg_get_serial_sequence(quote_ident(c.relname), a.attname) IS NOT NULL
  LOOP
    EXECUTE format('SELECT max(%I) FROM %I', r.col, r.t) INTO m;
    PERFORM setval(r.seq, coalesce(m, 1), m IS NOT NULL);
    RAISE NOTICE '% . % → %', r.t, r.col, coalesce(m, 0);
  END LOOP;
END $$;

NOTICE:  customer . id → 6
NOTICE:  item . id → 2
NOTICE:  item2 . id → 2
NOTICE:  empty_t . id → 1
NOTICE:  c2 . id → 2

確認環境では、serial 列・IDENTITY 列・\copy で取り込んだテーブルのすべてが直り、次の INSERT が成功しました。ほかのスキーマもあるなら、'public'::regnamespace の部分を変えます。

ずれが起きる操作

データを移したら、最後に setval を実行する手順にしておくと防げます。

IDENTITY 列と serial の違い

PostgreSQL 10 以降は、serial の代わりに IDENTITY 列も使えます。

INSERT INTO item (id, name) VALUES (1, 'a');      -- ALWAYS の列に id を指定
ERROR:  cannot insert a non-DEFAULT value into column "id"
DETAIL:  Column "id" is an identity column defined as GENERATED ALWAYS.
HINT:  Use OVERRIDING SYSTEM VALUE to override.

GENERATED ALWAYS なら、うっかり id を指定した INSERT を止められます。 ただし、ヒントにある OVERRIDING SYSTEM VALUE を付けて入れた場合は、同じようにずれました（確認環境でも、そのあとの INSERT が Key (id)=(1) already exists.）。直し方は serial と同じ setval です。

本当に重複しているとき

制約の名前が _pkey でなければ、シーケンスとは関係ありません。

ERROR:  duplicate key value violates unique constraint "customer_email_key"
DETAIL:  Key (email)=(sato@example.com) already exists.

DETAIL に、重複した列と値が表示されます。 同じメールアドレスが入ってくる可能性があるなら、ON CONFLICT で扱いを決めます。

INSERT INTO customer (name, email) VALUES ('別人', 'sato@example.com')
ON CONFLICT (email) DO NOTHING;              -- 重複なら何もしない（INSERT 0 0）

アプリでは、このエラーの SQLSTATE は 23505 です。Java なら SQLException.getSQLState()、Python（psycopg）なら errors.UniqueViolation で判定できます。

確認の手順（チェックリスト）

よくある質問

Q. シーケンスの番号が飛んでいます（1, 2, 5 など）。問題ですか。 A. 問題ありません。失敗した INSERT やロールバックでも番号は使われるため、PostgreSQL のシーケンスは「すき間のない連番」にはなりません（公式ドキュメント）。請求書番号のように連番が必要なら、別の採番の仕組みを使います。

Q. TRUNCATE したあと、id を 1 から始めたいです。 A. TRUNCATE TABLE customer RESTART IDENTITY; で、テーブルを空にすると同時にシーケンスも最初に戻せます。データを残したまま戻すと、今回のエラーの原因になります。

まとめ

• _pkey の重複で、id を指定していないなら、シーケンスのずれ
• id を指定した INSERT・COPY では、シーケンスは進まない
• 直し方は setval(pg_get_serial_sequence('t', 'id'), max(id))。移行後は全テーブルをまとめて直す
• 失敗した INSERT でも番号は進む。何回かやると通るのは、直ったのではない
• GENERATED ALWAYS AS IDENTITY なら、id を指定した INSERT を止められる
• _pkey 以外の制約なら本当の重複。ON CONFLICT で扱いを決める

参考・出典

確認日はいずれも 2026年10月11日です。

• PostgreSQL 16 Documentation「Sequence Manipulation Functions」：https://www.postgresql.org/docs/16/functions-sequence.html

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。