// Referência de erro do PostgreSQL

PostgreSQL 22P02: sintaxe de entrada inválida para o tipo

Um valor de texto não pôde ser convertido para o tipo de destino: letras em um inteiro, um UUID malformado, JSON inválido, uma string vazia para um número.

SQLSTATE
22P02
Nome
invalid_text_representation
Categoria
Exceção de dados
Mensagem de erro
invalid input syntax for type integer: "abc"

O que significa

O PostgreSQL converte literais e textos em valores tipados usando a função de entrada de cada tipo. Quando o texto não é uma representação válida do tipo, a conversão falha com 22P02 e a mensagem mostra o valor culpado.

O valor pode vir de um literal na consulta, um parâmetro vinculado, um CAST, ou uma coluna de texto sendo comparada com ou inserida em uma coluna tipada.

Causas comuns

  • Comparando uma coluna numérica ou UUID com uma string que não é um número nem um UUID, por exemplo WHERE id = 'abc' ou uma string vazia ''.
  • Passar uma string vazia onde se espera um número. O PostgreSQL não converte '' em NULL ou 0.
  • Entrada malformada para uuid, json/jsonb, boolean, inet ou um literal de array.
  • Em massa COPY ou cargas CSV onde uma linha tem texto em uma coluna numérica.

Como corrigir

  1. Encontre linhas que não seriam convertidas antes de fazer o cast delas (o PostgreSQL 16 e posteriores têm pg_input_is_valid).

    SELECT raw_value
    FROM staging
    WHERE NOT pg_input_is_valid(raw_value, 'integer');
  2. Em versões mais antigas, filtre com um padrão antes de fazer o cast.

    SELECT raw_value::int
    FROM staging
    WHERE raw_value ~ '^-?[0-9]+$';
  3. Transforme strings vazias em NULL explicitamente.

    SELECT NULLIF(trim(raw_value), '')::int FROM staging;
  4. No código de aplicação, vincule parâmetros com o tipo correto em vez de construir strings SQL, e valide a entrada antes que ela chegue ao banco de dados.

Reproduza com segurança

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

Erros relacionados

Mais erros de exceção de dados

O código e o texto da mensagem são de documentação do PostgreSQL, Apêndice A: Códigos de erro do PostgreSQL. Veja toda a Lista de erros do PostgreSQL ou pesquise todos os erros do banco de dados.

// menos erros, correções mais rápidas

Trabalhe com PostgreSQL no SQLly

Um cliente SQL nativo para macOS, Windows e Linux com IntelliSense que conhece o esquema, proteções para instruções arriscadas e mensagens de erro claras, para o PostgreSQL e os outros bancos de dados que você usa.