Verbindungsprobleme in BigBlueButton

Wenn BigBlueButton keine stabile Verbindung zum Server aufbauen oder aufrechterhalten kann, erscheinen verschiedene Fehlermeldungen. Dieser Artikel erklärt alle verbindungsbezogenen Meldungen, ihre Ursachen und was Sie dagegen tun können. Die meisten dieser Probleme lösen sich von selbst – in manchen Fällen ist jedoch ein Eingreifen nötig.

Verbindung zum Server nicht möglich

Apologies, trouble connecting to the server.

Wann tritt das auf?

Diese Meldung erscheint direkt beim Laden der Konferenzseite, wenn der BBB-Client überhaupt keine Verbindung zum Anwendungsserver herstellen kann. Sie ist in der Regel die erste Meldung, die Sie sehen, wenn der Server nicht erreichbar ist.

Mögliche Ursachen

  • Der BBB-Dienst (bbb-html5) läuft nicht auf dem Server
  • Der Webserver (nginx) leitet WebSocket-Verbindungen nicht korrekt weiter
  • Der Server ist überlastet (kein Arbeitsspeicher oder 100 % CPU-Auslastung)
  • Das SSL-Zertifikat ist ungültig oder abgelaufen
  • Eine Firewall blockiert Port 443 auf Ihrer Seite oder auf dem Server

Lösungen

  1. Laden Sie die Seite neu und versuchen Sie es erneut
  2. Prüfen Sie, ob andere Webseiten erreichbar sind, um ein lokales Netzwerkproblem auszuschließen
  3. Wenden Sie sich an den Server-Administrator, falls das Problem bestehen bleibt

Server antwortet nicht

Server not responding. Please wait.

Wann tritt das auf?

Die Verbindung zum Server besteht technisch, aber der Server sendet keine Daten mehr. Die Konferenzoberfläche friert ein, die Sitzung wird jedoch nicht beendet – der Client wartet darauf, dass der Server wieder reagiert. Dies entspricht dem Verbindungscode 3003.

Mögliche Ursachen

  • Die GraphQL-Komponente des Servers (Hasura) ist überlastet
  • Datenbankabfragen verursachen einen Rückstau
  • Die Netzwerkverbindung lässt zwar die Verbindung offen, blockiert aber den Datenfluss

Lösungen

  1. Warten Sie ab – die Meldung verschwindet automatisch, sobald der Server wieder antwortet
  2. Falls die Meldung länger als eine Minute bestehen bleibt, laden Sie die Seite neu
  3. Informieren Sie den Administrator, wenn das Problem wiederholt auftritt

Daten werden langsam geladen

Data is slow to load. Please wait.

Wann tritt das auf?

Der Server ist erreichbar und antwortet auf Anfragen, aber die Daten für die Konferenz werden verzögert bereitgestellt. Dies entspricht dem Verbindungscode 3005 und ist in der Regel ein vorübergehendes Problem.

Mögliche Ursachen

  • Viele Teilnehmende in der Konferenz verursachen kurzzeitige Verzögerungen
  • Die serverseitige Datenverarbeitung ist vorübergehend überlastet

Lösungen

  1. Warten Sie einige Sekunden – dieses Problem löst sich in der Regel von selbst
  2. Falls die Meldung länger bestehen bleibt, laden Sie die Seite neu

Verbindung verloren

Lost connection. Please check your internet.

Wann tritt das auf?

Die WebSocket-Verbindung zum Server wurde unterbrochen (Verbindungscode 3001). Der Client versucht automatisch, die Verbindung wiederherzustellen – bis zu 20 Mal innerhalb von jeweils 30 Sekunden.

Mögliche Ursachen

  • Ihre Internetverbindung wurde kurzzeitig unterbrochen (z. B. WLAN-Wechsel, Mobilfunk-Handover)
  • Der Server wurde neu gestartet
  • Eine Zeitüberschreitung im Webserver (nginx) hat die Verbindung getrennt

Lösungen

  1. Warten Sie auf die automatische Wiederverbindung – laden Sie die Seite nicht manuell neu, da der Client dies selbst übernimmt
  2. Prüfen Sie Ihre Internetverbindung (WLAN-Symbol, Netzwerkkabel)
  3. Falls die Wiederverbindung nach einer Minute nicht gelingt, laden Sie die Seite neu und treten Sie der Konferenz erneut bei

Anwendungsfehler – Wiederherstellung

Something went wrong. Attempting to recover…
Unable to recover after multiple attempts.

Wann tritt das auf?

Ein interner Fehler in der BBB-Webanwendung ist aufgetreten. Das System versucht automatisch, die betroffene Komponente wiederherzustellen. Falls dies mehrfach fehlschlägt, erscheint die zweite Meldung.

Mögliche Ursachen

  • Ein Softwarefehler in der aktuellen BBB-Version
  • Eine Browser-Erweiterung stört die Ausführung der Anwendung
  • Dem Browser geht der Arbeitsspeicher aus
  • Ein Timing-Problem während einer Wiederverbindung

Lösungen

  1. Warten Sie zunächst auf die automatische Wiederherstellung
  2. Falls die Meldung Unable to recover erscheint, laden Sie die Seite mit Strg+R (Windows/Linux) oder Cmd+R (Mac) neu
  3. Deaktivieren Sie testweise Browser-Erweiterungen (insbesondere Werbeblocker)
  4. Schließen Sie andere Tabs und Programme, um Arbeitsspeicher freizugeben

Client reagiert nicht

Client not responding

Wann tritt das auf?

Hier liegt das Problem nicht beim Server, sondern bei Ihrem Gerät: Der Browser kann die Konferenz-Ereignisse nicht schnell genug verarbeiten. Dies geschieht, wenn Ihr Gerät stark ausgelastet ist.

Mögliche Ursachen

  • Zu viele geöffnete Browser-Tabs oder Programme
  • Der Browser-Tab mit BBB läuft im Hintergrund und wird vom System gedrosselt
  • Das Gerät hat zu wenig freien Arbeitsspeicher

Lösungen

  1. Schließen Sie nicht benötigte Browser-Tabs und Anwendungen
  2. Stellen Sie sicher, dass der BBB-Tab im Vordergrund ist
  3. Auf Mobilgeräten: Halten Sie die BBB-App bzw. den Browser im Vordergrund

Verbindungsverlust erkannt / Offline

A loss in your connection has been detected
offline

Wann tritt das auf?

BBB hat eine Unterbrechung Ihrer Internetverbindung festgestellt. Die Meldung offline erscheint, wenn der Browser meldet, dass überhaupt keine Netzwerkverbindung mehr besteht.

Lösungen

  1. Prüfen Sie Ihre Internetverbindung (WLAN, Netzwerkkabel, Mobilfunk)
  2. Stellen Sie die Verbindung wieder her – der Client verbindet sich automatisch erneut

Verbindung nicht möglich – Code 3002

Unable to connect. Please check your internet connection (code 3002)

Wann tritt das auf?

Dies ist die schwerwiegendste Verbindungsmeldung: Die WebSocket-Verbindung ist unterbrochen und gleichzeitig ist die Netzwerklatenz kritisch hoch. Ihre Netzwerkverbindung ist stark beeinträchtigt.

Lösungen

  1. Prüfen Sie Ihre Internetverbindung
  2. Gehen Sie näher an Ihren WLAN-Router oder wechseln Sie zu einer kabelgebundenen Verbindung
  3. Auf Mobilgeräten: Wechseln Sie zwischen WLAN und Mobilfunk, um die stabilere Verbindung zu nutzen

Instabile Verbindung – Code 3004

Connection is unstable. Please check your internet connection (code 3004)

Wann tritt das auf?

Die Verbindung zum Server besteht zwar technisch, aber der Server sendet keine Daten und die Netzwerklatenz ist kritisch hoch. Dies kombiniert Serverprobleme mit einer schlechten Netzwerkverbindung.

Lösungen

  1. Prüfen Sie Ihre Netzwerkverbindung und verbessern Sie diese, falls möglich
  2. Laden Sie die Seite neu
  3. Falls das Problem bestehen bleibt, wenden Sie sich an den Server-Administrator

Live-Daten konnten nicht geladen werden – Code 3006

Some live data could not be loaded. Please refresh your client (code 3006)

Wann tritt das auf?

Die Verbindung zum Server funktioniert einwandfrei, aber eine bestimmte Datenabfrage (GraphQL-Subscription) ist fehlgeschlagen. Bestimmte Konferenz-Informationen können dadurch nicht angezeigt werden.

Mögliche Ursachen

  • Nach einem BBB-Update stimmen Datenbankstruktur und Anwendung nicht überein
  • Ein serverseitiger Konfigurationsfehler in der Datenverarbeitung

Lösungen

  1. Laden Sie die Seite neu, wie in der Meldung empfohlen – die Datenabfrage wird dabei neu aufgebaut
  2. Falls das Problem nach dem Neuladen bestehen bleibt, informieren Sie den Server-Administrator

Technische Details für Administratoren

Die Verbindungscodes (3001–3006) werden vom BBB-Connection-Manager vergeben und spiegeln den Zustand der GraphQL-WebSocket-Verbindung wider (ab BBB 3.0). Die wichtigsten Diagnosebefehle:

sudo bbb-conf --check
sudo systemctl status bbb-html5 bbb-graphql-middleware bbb-graphql-server nginx
sudo journalctl -u bbb-graphql-server -n 50
sudo journalctl -u nginx -n 50 | grep error

Bei Code 3006 nach einem Update: Führen Sie sudo bbb-conf --clean aus, um sicherzustellen, dass alle Datenbankmigrationen angewendet wurden. Bei anhaltenden Problemen mit Codes 3003–3005 prüfen Sie die Hasura- und PostgreSQL-Auslastung.