QOMET / Firebird Fehlermeldung

Eigenschaft	Details
Fehlermeldung	internal Firebird consistency check (can't attach after bugcheck)
SQLState	XX000
ISC Error Code	335544333
Betrifft	QOMET (alle Clients + Serverkonsole)
Datenbankengine	Firebird RDBMS
Schweregrad	Kritisch – keine Verbindung mehr möglich

1. Symptome

Folgende Anzeichen deuten auf diesen Fehler hin:

Beim Start von QOMET erscheint sofort eine Fehlermeldung
Fehlermeldung zeigt: „Fehler beim Ausführen von getEntitiesByQuery: SELECT FIRST 1 * FROM USERAUTH ORDER BY UAU_ID“
Der Fehler tritt auf allen Clients auf – unabhängig vom Arbeitsplatz
Auch direkt am Server ist QOMET nicht startbar
Keine Verbindung zur Datenbank möglich

⚠️ Wichtiger Hinweis: Da der Fehler auf ALLEN Clients und dem Server selbst auftritt, handelt es sich

nicht um ein Netzwerk- oder Client-Problem, sondern um einen Serverdienst-Fehler.

2. Ursache

Der Fehler „can't attach after bugcheck“ (ISC error 335544333) bedeutet, dass der Firebird-Datenbankserver einen internen kritischen Fehler („Bugcheck“) erlebt hat. Nach einem solchen Fehler verweigert der Firebird-Dienst alle neuen Verbindungsversuche als Sicherheitsmaßnahme.

Dieser Zustand bleibt bestehen, bis der Dienst manuell neu gestartet wird. QOMET selbst ist dabei nicht die Ursache – es kann lediglich keine Verbindung mehr zur Datenbank aufbauen.

Häufige Auslöser

Ursache	Beschreibung	Wahrscheinlichkeit
Serverabsturz / Neustart	Firebird wurde nicht sauber beendet (z.B. durch Stromausfall oder erzwungenen Neustart)	Sehr hoch
Speicherfehler (RAM)	Defekter oder fehlerhafter Arbeitsspeicher im Server	Mittel
Festplattenprobleme	Fehler auf dem Datenträger, auf dem die .fdb-Datei liegt	Mittel
Antivirus-Interferenz	Antivirensoftware greift während Schreibvorgängen in die .fdb-Datei ein	Mittel
Korrupte Datenbankdatei	Datenbankseiten sind beschädigt (z.B. durch abgebrochene Transaktion)	Gering
Veraltete Firebird-Version	Ältere Versionen reagieren empfindlicher auf Systemunterbrechungen	Gering

3. Lösungsschritte

Die Schritte sind in der empfohlenen Reihenfolge aufgeführt. Beginnen Sie immer mit Schritt 1, bevor Sie weitere Maßnahmen ergreifen.

Schritt 1: Firebird-Dienst neu starten (Pflicht)

Dies ist der erste und wichtigste Schritt. In den meisten Fällen behebt ein Neustart des Dienstes das Problem sofort.

Option A: über die Windows-Dienstverwaltung

Taste Windows + R drücken, services.msc eingeben und mit Enter bestätigen
In der Liste den Dienst „Firebird Server“ (oder „FirebirdServerDefaultInstance“) suchen
Rechtsklick auf den Dienst → „Neu starten“ auswählen
Warten bis der Dienst den Status „Aktiv (wird ausgeführt)“ anzeigt
QOMET neu starten und prüfen ob die Fehlermeldung behoben ist

Option B: über die Eingabeaufforderung (als Administrator)

net stop FirebirdServerDefaultInstance

net start FirebirdServerDefaultInstance

✅ In den meisten Fällen ist nach dem Neustart des Firebird-Dienstes der Fehler behoben.

Wenn QOMET danach wieder funktioniert, sind keine weiteren Schritte notwendig.

Schritt 2: Firebird-Protokolldatei prüfen

Tritt der Fehler nach dem Neustart erneut auf, sollten die Protokolldateien von Firebird auf die eigentliche Ursache untersucht werden.

Standardpfad der Logdatei:

C:\Program Files\Firebird\Firebird_X_X\firebird.log

Suchen Sie in der Datei nach Einträgen mit den Schlagwörtern „bugcheck“, „error“ oder „corrupt“. Diese geben Aufschluss über den eigentlichen Ausloser des Fehlers.

Schritt 3: Datenbankintegrität prüfen

Mit dem Dienstprogramm gfix (im Lieferumfang von Firebird enthalten) kann die Integrität der Datenbankdatei überprüft werden.

Prüfung durchführen:

gfix -validate -full C:\Pfad\zur\QOMET-Datenbank.fdb -user SYSDBA -password masterkey

Falls Fehler gefunden werden, können diese mit folgendem Befehl repariert werden:

gfix -mend C:\Pfad\zur\QOMET-Datenbank.fdb -user SYSDBA -password masterkey

⚠️ Vor jeder Reparatur sollte ein Backup der .fdb-Datei erstellt werden.

Kopieren Sie die Datei an einen sicheren Ort, bevor Sie gfix -mend ausführen.

Schritt 4: Backup einspielen (letzter Ausweg)

Wenn die Datenbank so stark beschädigt ist, dass eine Reparatur nicht möglich ist, muss ein gesichertes Backup eingespielt werden.

gbak -restore C:\backup\qomet.fbk C:\Pfad\zur\QOMET-Datenbank.fdb -user SYSDBA -password masterkey

⚠️ Beim Einspielen eines Backups gehen alle Daten verloren, die seit dem letzten Backup

erfasst wurden. Bitte den zuständigen Systemadministrator hinzuziehen.

4. Prävention

Um diesen Fehler zukünftig zu vermeiden, werden folgende Maßnahmen empfohlen:

Reguläre automatische Backups der Firebird-Datenbankdatei (.fdb) einrichten

→ Empfohlen: tägliches Backup per Aufgabenplanung mit gbak

Firebird-Datenbankdatei (.fdb) in den Ausnahmen der Antivirensoftware eintragen

→ Verhindert, dass der AV-Scanner während Schreibzugriffen eingreift

USV (Unterbrechungsfreie Stromversorgung) für den Server verwenden

→ Schützt vor unsauberem Herunterfahren durch Stromausfall

SMART-Werte der Serverfestplatte regelmäßig überwachen

→ Frühzeitig Festplattenprobleme erkennen

Firebird auf dem aktuellen Stand halten

→ Aktuelle Versionen enthalten Stabiliätsverbesserungen

5. Weiterführende Unterstützung

Wenn das Problem nach diesen Schritten weiterhin besteht, wenden Sie sich bitte an Ihren Systemadministrator oder den QOMET-Support mit folgenden Informationen:

Inhalt der Firebird-Protokolldatei (firebird.log)
Screenshot der Fehlermeldung
Zeitpunkt des ersten Auftretens
Ausgabe von gfix -validate

📌 Dieser Artikel gilt für QOMET mit Firebird-Backend.

Erstellt: April 2025 | Status: Freigegeben | Nächste Überprüfung: Oktober 2025