Fehler 3006: Live-Daten konnten nicht geladen werden

Wenn BigBlueButton Ihnen die Meldung „Some live data could not be loaded. Please refresh your client (code 3006)” anzeigt, bedeutet das: Die Verbindung zum Server steht grundsätzlich – aber bestimmte Echtzeit-Daten konnten nicht geladen werden. Mit „Live-Daten” sind alle Inhalte gemeint, die BBB laufend aktualisiert: die Teilnehmerliste, den Chat-Verlauf, den Präsentationsstatus, Abstimmungsergebnisse und ähnliche Meeting-Informationen. Diese werden über das GraphQL-System im Hintergrund übertragen. Schlägt dabei eine einzelne Abfrage fehl, erscheint Fehler 3006.

Wie äußert sich der Fehler?

BBB zeigt einen Hinweisbalken mit der Meldung: „Some live data could not be loaded. Please refresh your client (code 3006)”

Im Unterschied zu anderen Verbindungsfehlern (z. B. 3001–3005) ist die WebSocket-Verbindung bei Fehler 3006 technisch intakt: Der Server antwortet, die Keep-alive-Signale kommen an – aber eine konkrete GraphQL-Subscription (eine Datenabfrage im Hintergrund) hat einen Fehler zurückgegeben. Das Meeting kann deshalb teilweise eingefroren oder unvollständig wirken, obwohl die Verbindung selbst stabil ist.

Mögliche Ursachen

  • Schema-Konflikt nach einem Update: Eine GraphQL-Abfrage verweist auf ein Datenbankfeld, das nach einem unvollständigen BBB-Update nicht mehr existiert.
  • Hasura-Metadaten veraltet: Nach einem Upgrade wurden die Hasura-Metadaten nicht neu geladen, sodass Tabellen oder Felder nicht gefunden werden.
  • PostgreSQL nicht erreichbar oder inkonsistent: Das Datenbanksystem, aus dem Hasura die Meeting-Daten liest, ist ausgefallen oder eine Migration wurde nur teilweise ausgeführt.
  • Ungültiges JWT-Token: Das Authentifizierungstoken des Nutzers wird von Hasura abgelehnt – beispielsweise weil die Konfiguration nach einem Update nicht synchron ist.
  • Meeting existiert nicht mehr: Das Meeting wurde beendet oder der Server wurde neugestartet, während der Client noch einen alten Join-Link verwendet.
  • bbb-apps-akka schreibt keine Daten: Der Anwendungsserver, der den Meeting-Zustand erzeugt, ist abgestürzt oder hat aufgehört, Ereignisse in die Datenbank zu schreiben.

Lösungen

Für Teilnehmer

  1. Seite neu laden: Drücken Sie F5 bzw. Strg+R (Windows/Linux) oder Cmd+R (Mac). In den meisten Fällen stellt BBB die Subscription beim erneuten Laden automatisch wieder her.
  2. Meeting neu beitreten: Falls das Neuladen nicht hilft, verlassen Sie das Meeting und öffnen Sie den Beitrittslink erneut.
  3. Browser-Cache leeren: Bei anhaltenden Problemen kann ein geleerte Cache helfen: Strg+Shift+Entf → „Gecachte Bilder und Dateien” löschen.
  4. Administrator informieren: Wenn der Fehler bei mehreren Teilnehmern gleichzeitig auftritt, liegt die Ursache auf dem Server. Wenden Sie sich an den BBB-Administrator.

Für Administratoren

  1. Alle BBB-Dienste prüfen:
sudo bbb-conf --check
sudo systemctl status bbb-apps-akka bbb-graphql-middleware postgresql nginx
  1. Hasura-Logs auf Schema- und Metadatenfehler untersuchen:
sudo journalctl -u bbb-graphql-middleware -n 200 --no-pager | grep -iE "error|metadata|schema|unauthorized|permission"

Sind Metadatenfehler erkennbar (häufig nach einem Update), hilft ein Neustart des Dienstes:

sudo systemctl restart bbb-graphql-middleware
  1. PostgreSQL und Datenbankstruktur prüfen:
sudo systemctl status postgresql
sudo -u postgres psql -c "\l"
sudo -u postgres psql -d bbb_meetings -c "\dt"

Fehlen Tabellen (z. B. nach einer fehlgeschlagenen Migration), führen Sie folgende Befehle aus:

sudo bbb-conf --clean
sudo bbb-conf --restart
  1. bbb-apps-akka prüfen:
sudo journalctl -u bbb-apps-akka -n 200 --no-pager | grep -iE "error|exception|postgres|graphql"
sudo systemctl status bbb-apps-akka
  1. JWT-Konfiguration prüfen (BBB 3.0): Wenn das Authentifizierungstoken zwischen bbb-graphql-middleware und Hasura nicht übereinstimmt, werden alle Subscriptions abgelehnt.
grep -r "JWT_SECRET\|HASURA_GRAPHQL_JWT_SECRET" /etc/bigbluebutton/ /usr/share/bbb-graphql-middleware/

Bei Abweichungen: BBB neu konfigurieren und alle Dienste neu starten.

sudo bbb-conf --setip $(hostname -I | awk '{print $1}')
sudo bbb-conf --restart
  1. Vollständiger Reset als letzter Ausweg:
sudo bbb-conf --clean
sudo bbb-conf --check
sudo bbb-conf --restart

Weitere Informationen

Fehler 3006 tritt ausschließlich auf der Datenschicht auf und ist damit klar von Transportfehlern abzugrenzen. Verwandte Fehlercodes, die Sie ebenfalls kennen sollten:

  • Fehler 3004 – Verbindung instabil (Server antwortet nicht, RTT kritisch)
  • Fehler 3005 – Daten werden langsam geladen (Hasura-Subscription verzögert, aber Verbindung stabil)