PostgreSQL 22P02: ungültige Eingabesyntax für Typ
Ein Textwert konnte nicht in den Zieltyp konvertiert werden: Buchstaben in eine ganze Zahl, eine fehlerhafte UUID, fehlerhaftes JSON, eine leere Zeichenfolge in eine Zahl.
- SQLSTATE
22P02- Name
invalid_text_representation- Kategorie
- Daten-Ausnahme
Was es bedeutet
PostgreSQL wandelt Literale und Text mit der Eingabefunktion jedes Typs in typisierte Werte um. Wenn der Text keine gültige Darstellung des Typs ist, schlägt die Konvertierung mit 22P02 fehl und die Meldung zitiert den fehlerhaften Wert.
Der Wert kann aus einem Literal in der Abfrage, einem gebundenen Parameter, einem CAST, oder eine Textspalte, die mit einer typisierten Spalte verglichen oder in sie eingefügt wird.
Häufige Ursachen
- Vergleich einer numerischen oder UUID-Spalte mit einer Zeichenkette, die keine Zahl oder UUID ist, zum Beispiel
WHERE id = 'abc'oder ein leerer String''. - Übergabe eines leeren Strings, wo eine Zahl erwartet wird. PostgreSQL wandelt
''inNULLoder 0. - Fehlerhafte Eingabe für
uuid,json/jsonb,boolean,inetoder ein Arrayliteral. - Massenvorgänge
COPYoder CSV-Importe, bei denen eine Zeile Text in einer numerischen Spalte enthält.
Wie du es behebst
-
Finde Zeilen, die sich nicht konvertieren lassen, bevor du sie umwandelst (PostgreSQL 16 und höher haben
pg_input_is_valid).SELECT raw_value FROM staging WHERE NOT pg_input_is_valid(raw_value, 'integer');
-
In älteren Versionen mit einem Muster filtern, bevor die Konvertierung erfolgt.
SELECT raw_value::int FROM staging WHERE raw_value ~ '^-?[0-9]+$';
-
Verwandle leere Zeichenketten in
NULLexplizit.SELECT NULLIF(trim(raw_value), '')::int FROM staging;
-
Im Anwendungscode binde Parameter mit dem richtigen Typ, statt SQL-Strings zu bauen, und prüfe Eingaben, bevor sie die Datenbank erreichen.
Sicher reproduzieren
SELECT 'abc'::int; -- ERROR: invalid input syntax for type integer: "abc"
Zugehörige Fehler
22003Numerischer Wert außerhalb des zulässigen Bereichs22007Ungültiges Datums-/Uhrzeitformat42804Datentyp stimmt nicht überein22021Ungültige Byte-Sequenz für die Kodierung245SQL Server: Konvertierung eines Werts fehlgeschlagen1366MySQL: Falscher Wert für SpalteORA-01722Oracle: ungültige Zahl
Weitere Fehler bei Daten-Exceptions
22008Datum-/Uhrzeitfeldwert außerhalb des zulässigen Bereichs22012Division durch null22023Ungültiger Parameterwert22001Wert zu lang für den Typ
Der Code und der Meldungstext stammen aus der PostgreSQL-Dokumentation, Anhang A: PostgreSQL-Fehlercodes. Durchstöbere die vollständige PostgreSQL-Fehlerliste oder Jeden Datenbankfehler durchsuchen.
Arbeiten mit PostgreSQL in SQLly
Ein nativer SQL-Client für macOS, Windows und Linux mit schemabewusstem IntelliSense, Guardrails für riskante Anweisungen und klaren Fehlermeldungen, für PostgreSQL und die anderen Datenbanken, mit denen du arbeitest.