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
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
''enNULLo 0. - Entrada malformada para
uuid,json/jsonb,boolean,ineto un literal de arreglo. - Carga masiva
COPYo cargas CSV donde una fila tiene texto en una columna numérica.
Cómo solucionarlo
-
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');
-
En versiones anteriores, filtra con un patrón antes de hacer el casting.
SELECT raw_value::int FROM staging WHERE raw_value ~ '^-?[0-9]+$';
-
Convierte las cadenas vacías en
NULLexplícitamente.SELECT NULLIF(trim(raw_value), '')::int FROM staging;
-
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
22003valor numérico fuera de rango22007formato de fecha/hora no válido42804incompatibilidad de tipos de datos22021secuencia de bytes no válida para la codificación245SQL Server: Error al convertir un valor1366MySQL: valor incorrecto para la columnaORA-01722Oracle: número no válido
Más errores de excepción de datos
22008valor del campo fecha/hora fuera de rango22012división por cero22023valor de parámetro no válido22001valor demasiado largo para el tipo
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.
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.