Ошибка 23505 PostgreSQL (unique_violation): как исправить.
Частые запросы: vacuum индексы блокировки 1С

Ошибка PostgreSQL 23505 (unique_violation)

Ошибка 23505 (unique_violation) означает, что вставка или обновление нарушает уникальное ограничение: значение ключа уже есть в таблице. Срабатывает на первичном ключе, ограничении UNIQUE или уникальном индексе. В тексте ошибки указаны имя ограничения и конфликтное значение:

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

Частые причины

  • Значение действительно дублируется – запись с таким ключом уже существует.
  • Рассинхрон последовательности: значение счетчика отстало от реальных данных, и автоинкремент выдает уже занятый ID. Частое последствие импорта данных с явными ID.
  • Логика приложения повторно вставляет одну и ту же запись.

Как разобраться и исправить

      1. Прочитайте DETAIL — там указаны столбцы и значение, вызвавшие конфликт. Для составного ограничения перечислены все столбцы.
      2. Проверьте, настоящий ли это дубликат: найдите в таблице строку с этим значением ключа.
      3. Если причина в рассинхроне последовательности — приведите ее к максимальному ID. COALESCE нужен, чтобы команда отработала и на пустой таблице (иначе MAX вернет NULL и setval ничего не выставит):
      4. SELECT setval(
        pg_get_serial_sequence('users', 'id'),
        COALESCE(MAX(id), 1),
        MAX(id) IS NOT NULL
        )
        FROM users;

        Выполняйте синхронизацию, когда в таблицу нет активной конкурентной записи, и после проверьте результат — текущее значение последовательности должно быть не меньше максимального ID.

      5. Если дубликаты штатны для логики — используйте ON CONFLICT. Например, ON CONFLICT DO NOTHING молча пропустит конфликтную вставку, ON CONFLICT … DO UPDATE обновит существующую строку.

Проверьте PGLens
на своих данных

Подключите PGLens к своим экземплярам и получите структурированную картину нагрузки вместо разрозненных данных из логов и системных представлений.

  • Картина нагрузки по подключенным экземплярам в динамике
  • Ранжированный список самых тяжелых запросов
  • Моделирование индексов с расчетом выигрыша в стоимости запроса

    * - обязательные поля

    Напишите нам
    Удобнее с телефона?
    Сканируйте QR