// справочник ошибок PostgreSQL

PostgreSQL 23502: значение NULL нарушает ограничение NOT NULL

INSERT или UPDATE оставили столбец NOT NULL пустым, часто потому, что столбец был упущен и не имеет значения по умолчанию.

SQLSTATE
23502
Имя
not_null_violation
Категория
Нарушение ограничения целостности
Сообщение об ошибке
null value in column "email" of relation "users" violates not-null constraint
DETAIL:  Failing row contains (7, Ada, null).

Что это значит

A NOT NULL в каждом ряду столбец должен иметь значение. 23502 означает, что новая или обновленная строка имела NULL его там, либо явно, либо потому что столбец был опущен в INSERT и его значение по умолчанию NULL.

Этот DETAIL строка показывает всю проблемную строку. PostgreSQL 13 и новее называют таблицу в сообщении; более старые говорят только null value in column "email" violates not-null constraint.

Распространённые причины

  • Этот INSERT не перечисляет столбец и столбец не имеет DEFAULT.
  • Приложение отправило NULL, например, незаполненное поле или неудачный поиск.
  • INSERT ... SELECT или UPDATE с подзапросом, который не вернул строк, вызывая NULL.
  • Столбец, добавленный с NOT NULL о котором существующий код не знает.

Как исправить

  1. Укажите значение или задайте столбцу значение по умолчанию.

    INSERT INTO users (id, name, email) VALUES (7, 'Ada', '[email protected]');
    ALTER TABLE users ALTER COLUMN created_at SET DEFAULT now();
  2. Используйте COALESCE когда поиск или выражение может вернуть NULL.

    UPDATE orders o
    SET region = COALESCE((SELECT region FROM customers c WHERE c.id = o.customer_id), 'unknown');
  3. Если столбец должен допускать пропущенные значения, удалите ограничение.

    ALTER TABLE users ALTER COLUMN phone DROP NOT NULL;

Безопасное воспроизведение

CREATE TEMP TABLE u (id int, email text NOT NULL);
INSERT INTO u (id) VALUES (1);  -- ERROR: null value in column "email" of relation "u" violates not-null constraint

Связанные ошибки

Больше ошибок нарушения ограничений целостности

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.