// PostgreSQL-Fehlerreferenz

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
Fehlermeldung
invalid input syntax for type integer: "abc"

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 '' in NULL oder 0.
  • Fehlerhafte Eingabe für uuid, json/jsonb, boolean, inet oder ein Arrayliteral.
  • Massenvorgänge COPY oder CSV-Importe, bei denen eine Zeile Text in einer numerischen Spalte enthält.

Wie du es behebst

  1. 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');
  2. In älteren Versionen mit einem Muster filtern, bevor die Konvertierung erfolgt.

    SELECT raw_value::int
    FROM staging
    WHERE raw_value ~ '^-?[0-9]+$';
  3. Verwandle leere Zeichenketten in NULL explizit.

    SELECT NULLIF(trim(raw_value), '')::int FROM staging;
  4. 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

Weitere Fehler bei Daten-Exceptions

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.

// weniger Fehler, schnellere Korrekturen

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.