Railsのエラー『PG::UniqueViolation: ERROR: duplicate key value violates unique constraint』の解決方法

Railsでデータを保存しようとした際に、PG::UniqueViolation エラーが発生することがある。このエラーは、データベースの一意制約（UNIQUE制約）に違反している場合に発生する。主な原因と解決策を詳しく解説する。

エラーの発生条件

このエラーは、テーブルのカラムに設定された UNIQUE 制約を満たさないデータを挿入または更新しようとしたときに発生する。例えば、以下のようなケースが考えられる。

• 一意制約のあるカラムに重複データを挿入しようとした
• データベースのシーケンス（自動採番）がずれていて、既存のデータと衝突した
• ユニークキーを意図せず重複する値に変更しようとした

エラーメッセージの例

ActiveRecord::RecordNotUnique: PG::UniqueViolation: ERROR:  duplicate key value violates unique constraint "users_email_key"
DETAIL:  Key (email)=(example@example.com) already exists.

原因1: データの重複

最も一般的な原因は、データの重複によるもの。一意制約のあるカラム（例: email）に、すでに存在する値を挿入しようとするとエラーが発生する。

解決策: データの重複チェック

データを挿入する前に、既存データと重複していないかを確認する。

if User.exists?(email: "example@example.com")
  puts "既に存在するメールアドレスです"
else
  User.create(email: "example@example.com")
end

原因2: シーケンスのずれ

PostgreSQLでは、id カラムが serial 型の場合、内部で sequence が使用される。バックアップからデータを復元したり、手動でIDを設定した場合、シーケンスが最新のIDを反映しておらず、次に挿入するIDが既存のデータと衝突することがある。

解決策: シーケンスをリセット

現在の最大IDにシーケンスを合わせる。

ActiveRecord::Base.connection.execute("SELECT setval('users_id_seq', (SELECT MAX(id) FROM users))")

原因3: ユニークキーを意図せず変更

レコードの更新時に、ユニークキーを重複する値に変更しようとするとエラーが発生する。

解決策: 更新前に重複チェック

user = User.find(1)
if User.where(email: "new@example.com").exists? && user.email != "new@example.com"
  puts "このメールアドレスは既に使用されています"
else
  user.update(email: "new@example.com")
end

原因4: バルクインサート時の競合

バルクインサートを使用すると、同時に複数のレコードを挿入するため、一意制約に違反する可能性がある。

解決策: on_conflict を使用

Rails 6 以降では、PostgreSQL の ON CONFLICT 句を活用できる。

User.insert_all([
  { email: "example@example.com", name: "User 1" },
  { email: "example2@example.com", name: "User 2" }
], on_duplicate: :skip)

原因5: マイグレーションミス

テーブルを変更するマイグレーションを適用した際に、意図せず重複データが発生することがある。

解決策: 重複データの削除

duplicate_users = User.group(:email).having("count(email) > 1").pluck(:email)
User.where(email: duplicate_users).destroy_all

まとめ

このエラーは、データの一意制約を守るために発生するため、無理に回避せず適切な対応を取ることが重要。データの重複チェックやシーケンスのリセット、on_conflict などを活用することで、適切に対処できる。