PostgreSQL XX000: interner Fehler
PostgreSQL ist auf einen Zustand gestoßen, den seine Entwickler für unmöglich halten. Oft eine Race Condition mit gleichzeitigen DDL-Vorgängen, manchmal ein Bug oder eine Beschädigung. Notiere dir die Details.
- SQLSTATE
XX000- Name
internal_error- Kategorie
- Interner Fehler
Was es bedeutet
XX000 (internal_error) ist der Code für interne Fehler, die mit elog(ERROR, ...)ausgelöst werden, den PostgreSQL für Bedingungen verwendet, die im normalen Betrieb nicht auftreten sollten. Meldungen sind kurz und technisch, wie z. B. cache lookup failed for relation 16397, could not find pathkey item to sort oder unexpected chunk number.
Manche werden ausgelöst, wenn eine Tabelle oder Funktion gelöscht wird, während eine andere Sitzung sie verwendet. Andere deuten auf einen Fehler in PostgreSQL oder einer Erweiterung oder auf Datenkorruption hin, insbesondere wenn sie sich beim selben Objekt wiederholen.
Häufige Ursachen
- Gleichzeitiges DDL: ein Objekt wurde gelöscht oder neu erstellt, während die Abfrage einer anderen Sitzung sich auf dessen OID bezog.
- Ein Fehler in PostgreSQL oder einer Erweiterung, der oft in einer späteren Minor-Version behoben wird.
- Beschädigte Katalog- oder Tabellendaten nach einem Hardware- oder Speicherfehler.
Wie du es behebst
-
Versuche, die Anweisung erneut auszuführen. War es ein Wettlauf mit DDL, gelingt sie, sobald die andere Änderung abgeschlossen ist.
-
Prüfe, ob der Server für seine Major-Version das neueste Minor-Release fährt; Minor-Releases beheben viele interne Fehler.
SELECT version();
-
Wenn der Fehler immer wieder bei einer Tabelle auftritt, prüfe sie auf Beschädigung (die
amcheck-Erweiterung prüft B-Tree-Indizes und seit PostgreSQL 14 auch Heap-Tabellen mitpg_amcheck), und stelle bei Bedarf aus einem Backup wieder her.CREATE EXTENSION IF NOT EXISTS amcheck; SELECT bt_index_check('orders_pkey'); -
Wenn du ihn reproduzieren kannst, melde ihn an die PostgreSQL-Bugliste, mit der Version, der vollständigen Fehlermeldung samt
\set VERBOSITY verboseund einem Skript.
Zugehörige Fehler
Weitere interne Fehler
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.