Fehler 3002: Verbindung zum Server nicht möglich

Der Fehlercode 3002 tritt auf, wenn der BigBlueButton-Client beim ersten Verbindungsaufbau zum Server scheitert. Anders als bei einem kurzzeitigen Verbindungsabbruch (Code 3001) kommt es hier gar nicht erst zu einer erfolgreichen WebSocket-Verbindung – die Sitzung kann deshalb nicht gestartet werden.

Wie äußert sich der Fehler?

Direkt beim Laden der Meeting-Seite, noch bevor die Benutzeroberfläche vollständig erscheint, zeigt BigBlueButton folgende Meldung an:

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

Die Seite bleibt leer oder zeigt einen Ladebildschirm, der sich nicht weiter aufbaut. Ein Eintritt in das Meeting ist nicht möglich.

Mögliche Ursachen

BBB-Dienste nicht gestartet: Der Anwendungsserver (bbb-html5 bzw. bbb-graphql-middleware) läuft nicht oder ist abgestürzt.
Server im Neustart: Ein Administrator hat bbb-conf --restart ausgeführt; die Dienste sind noch nicht vollständig bereit.
nginx-Fehlkonfiguration: Der Reverse-Proxy leitet WebSocket-Verbindungen nicht korrekt an den Backend-Dienst weiter.
Firewall oder Proxy blockiert die Verbindung: Port 443 oder WebSocket-Upgrade-Header werden von einer Unternehmens-Firewall, einem ISP-Proxy oder einem VPN blockiert.
DNS-Auflösung schlägt fehl: Der Hostname des BBB-Servers lässt sich im Netzwerk des Teilnehmers nicht auflösen.
Ungültiges oder abgelaufenes SSL-Zertifikat: Der Browser verweigert die verschlüsselte Verbindung, da das Zertifikat nicht vertrauenswürdig ist.
Serverüberlastung (OOM-Kill): Der bbb-graphql-middleware- oder bbb-html5-Prozess wurde vom Betriebssystem wegen Speichermangels beendet.

Lösungen

Für Teilnehmer

Internetverbindung prüfen: Öffnen Sie eine andere Website, um sicherzustellen, dass Ihre Verbindung funktioniert.
Seite neu laden: Drücken Sie F5 oder Strg+R (Mac: Cmd+R), um einen neuen Verbindungsversuch zu starten.
Browser-Cache leeren: Versuchen Sie einen harten Reload mit Strg+Shift+R (Mac: Cmd+Shift+R).
Anderen Browser oder Gerät testen: Wechseln Sie zu einem anderen Browser (z. B. von Firefox zu Chrome) oder testen Sie über ein Mobilgerät.
VPN oder Proxy deaktivieren: Schalten Sie VPN-Software oder Browser-Proxys vorübergehend aus – diese können WebSocket-Verbindungen blockieren.
Netzwerk wechseln: Falls Sie sich in einem Unternehmensnetzwerk befinden, versuchen Sie es über einen mobilen Hotspot. Manche Firewalls blockieren WebSocket-Verbindungen.
Kurz warten und erneut versuchen: Wenn der Server gerade neu gestartet wird, ist er nach wenigen Minuten wieder erreichbar.

Für Administratoren

Dienststatus prüfen: Überprüfen Sie, ob alle erforderlichen BBB-Dienste laufen.

sudo bbb-conf --check
sudo systemctl status bbb-html5
sudo systemctl status bbb-graphql-middleware
sudo systemctl status nginx

Falls ein Dienst ausgefallen ist, starten Sie alle BBB-Dienste neu:

sudo bbb-conf --restart

nginx-Fehlerprotokoll auswerten: Suchen Sie nach fehlgeschlagenen Upstream-Verbindungen.

sudo tail -50 /var/log/nginx/error.log

Einträge wie connect() failed, upstream oder 502 weisen auf einen nicht erreichbaren Backend-Dienst hin.

SSL-Zertifikat überprüfen:

sudo certbot renew --dry-run
sudo bbb-conf --check

OOM-Kills im Kernel-Log prüfen:

sudo dmesg | grep -iE "oom|killed"
free -h

bbb-graphql-middleware prüfen (BBB 3.0+): In BBB 3.0 läuft die WebSocket-Verbindung über nginx → bbb-graphql-middleware → Hasura → PostgreSQL. Ein Ausfall an jeder Stelle dieser Kette führt zu Fehlercode 3002.

sudo journalctl -u bbb-graphql-middleware -n 100 --no-pager
sudo ss -tlnp | grep 8085

bbb-hilfe.de