Ошибка 23505 (unique_violation) означает, что вставка или обновление нарушает уникальное ограничение: значение ключа уже есть в таблице. Срабатывает на первичном ключе, ограничении UNIQUE или уникальном индексе. В тексте ошибки указаны имя ограничения и конфликтное значение:
ERROR: duplicate key value violates unique constraint "users_email_key" DETAIL: Key (email)=(alice@example.com) already exists.
Частые причины
- Значение действительно дублируется – запись с таким ключом уже существует.
- Рассинхрон последовательности: значение счетчика отстало от реальных данных, и автоинкремент выдает уже занятый ID. Частое последствие импорта данных с явными ID.
- Логика приложения повторно вставляет одну и ту же запись.
Как разобраться и исправить
-
-
- Прочитайте DETAIL — там указаны столбцы и значение, вызвавшие конфликт. Для составного ограничения перечислены все столбцы.
- Проверьте, настоящий ли это дубликат: найдите в таблице строку с этим значением ключа.
- Если причина в рассинхроне последовательности — приведите ее к максимальному ID. COALESCE нужен, чтобы команда отработала и на пустой таблице (иначе MAX вернет NULL и setval ничего не выставит):
SELECT setval( pg_get_serial_sequence('users', 'id'), COALESCE(MAX(id), 1), MAX(id) IS NOT NULL ) FROM users;Выполняйте синхронизацию, когда в таблицу нет активной конкурентной записи, и после проверьте результат — текущее значение последовательности должно быть не меньше максимального ID.
- Если дубликаты штатны для логики — используйте ON CONFLICT. Например, ON CONFLICT DO NOTHING молча пропустит конфликтную вставку, ON CONFLICT … DO UPDATE обновит существующую строку.
-