// Referencia de errores de PostgreSQL

PostgreSQL 22P02: sintaxis de entrada no válida para el tipo

No se pudo convertir un valor de texto al tipo de destino: letras en un entero, un UUID malformado, JSON incorrecto, una cadena vacía en un número.

SQLSTATE
22P02
Nombre
invalid_text_representation
Categoría
Excepción de datos
Mensaje de error
invalid input syntax for type integer: "abc"

Qué significa

PostgreSQL convierte literales y texto en valores tipados con la función de entrada de cada tipo. Cuando el texto no es una representación válida del tipo, la conversión falla con 22P02 y el mensaje muestra el valor problemático.

El valor puede provenir de un literal en la consulta, un parámetro vinculado, un CAST, o una columna de texto que se esté comparando o insertando en una columna tipada.

Causas comunes

  • Comparar una columna numérica o UUID con una cadena que no es un número o UUID, por ejemplo WHERE id = 'abc' o una cadena vacía ''.
  • Pasar una cadena vacía donde se espera un número. PostgreSQL no convierte '' en NULL o 0.
  • Entrada malformada para uuid, json/jsonb, boolean, inet o un literal de arreglo.
  • Carga masiva COPY o cargas CSV donde una fila tiene texto en una columna numérica.

Cómo solucionarlo

  1. Encuentra las filas que no se convertirían antes de hacer el casting (PostgreSQL 16 y posteriores tienen pg_input_is_valid).

    SELECT raw_value
    FROM staging
    WHERE NOT pg_input_is_valid(raw_value, 'integer');
  2. En versiones anteriores, filtra con un patrón antes de hacer el casting.

    SELECT raw_value::int
    FROM staging
    WHERE raw_value ~ '^-?[0-9]+$';
  3. Convierte las cadenas vacías en NULL explícitamente.

    SELECT NULLIF(trim(raw_value), '')::int FROM staging;
  4. En el código de la aplicación, vincula parámetros con el tipo correcto en lugar de construir cadenas SQL, y valida la entrada antes de que llegue a la base de datos.

Reprodúcelo de forma segura

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

Errores relacionados

Más errores de excepción de datos

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.