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

PostgreSQL 22P02: недопустимый синтаксис ввода для типа

Значение текста не удалось преобразовать к целевому типу: буквы в число, некорректный UUID, неправильный JSON, пустая строка в число.

SQLSTATE
22P02
Имя
invalid_text_representation
Категория
Исключение данных
Сообщение об ошибке
invalid input syntax for type integer: "abc"

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

PostgreSQL преобразует литералы и текст в типизированные значения с помощью функции ввода каждого типа. Если текст не является допустимым представлением типа, преобразование завершается ошибкой 22P02, и в сообщении приводится проблемное значение.

Значение может прийти из литерала в запросе, привязанного параметра, CASTили столбца текста, который сравнивается с типизированным столбцом или вставляется в него.

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

  • Сравнение числового или UUID-столбца со строкой, которая не является числом или UUID, например WHERE id = 'abc' или пустая строка ''.
  • Передача пустой строки там, где ожидается число. PostgreSQL не превращает '' в NULL или 0.
  • Неверный ввод для uuid, json/jsonb, boolean, inet или литерала массива.
  • Массово COPY или загрузки CSV, где одна строка содержит текст в числовом столбце.

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

  1. Найдите строки, которые не удастся преобразовать, до приведения типов (в PostgreSQL 16 и новее есть pg_input_is_valid).

    SELECT raw_value
    FROM staging
    WHERE NOT pg_input_is_valid(raw_value, 'integer');
  2. В старых версиях фильтруйте по шаблону до приведения типов.

    SELECT raw_value::int
    FROM staging
    WHERE raw_value ~ '^-?[0-9]+$';
  3. Преобразуйте пустые строки в NULL явно.

    SELECT NULLIF(trim(raw_value), '')::int FROM staging;
  4. В коде приложения передавайте параметры с правильным типом вместо склейки SQL-строк и проверяйте ввод до того, как он попадёт в базу данных.

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

SELECT 'abc'::int;  -- ERROR: invalid input syntax for type integer: "abc"

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

Больше ошибок данных

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

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

Работа с PostgreSQL в SQLly

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