Fehler 1001: WebSocket-Verbindung unterbrochen

Der Fehlercode 1001 bedeutet, dass die WebSocket-Verbindung zwischen Ihrem Browser und dem BigBlueButton-Server während einer laufenden Konferenz unterbrochen wurde. Diese Verbindung ist für die Audio-Übertragung und (ab BBB 3.0) auch für den gesamten Datenaustausch zuständig. Typischerweise äußert sich der Fehler durch einen plötzlichen Ausfall des Tons mitten in der Konferenz.

Wie äußert sich der Fehler?

Im Audio-Dialog von BigBlueButton erscheint die Fehlermeldung „Fehler 1001″ zusammen mit dem Hinweis, dass die Verbindung getrennt wurde. Zusätzlich kann die Meldung „Error: Connection error” als Benachrichtigung eingeblendet werden.

Der Fehler tritt nicht beim Beitreten auf (das wäre Fehler 1002), sondern während einer bereits laufenden Konferenz. Ihr Audio wird plötzlich unterbrochen, und Sie müssen die Audioverbindung neu aufbauen oder die Seite neu laden.

Mögliche Ursachen

Auf Ihrer Seite (als Teilnehmer):

Instabile Internetverbindung – kurzzeitige Aussetzer im WLAN oder Mobilfunknetz
Netzwerkwechsel während der Konferenz, z. B. vom WLAN ins Mobilfunknetz
VPN-Verbindung, die zwischendurch abbricht oder die Verbindung stört
Firmen-Firewall, die lang laufende Verbindungen nach einer bestimmten Zeit automatisch trennt (häufig nach genau 5 oder 10 Minuten)

Auf Seiten des Servers (für Administratoren):

Der Webserver (nginx) wurde neu geladen – dabei werden alle bestehenden WebSocket-Verbindungen getrennt
Automatische SSL-Zertifikatserneuerung (z. B. durch Certbot), die einen nginx-Reload auslöst
Zu niedrige Timeout-Werte in der nginx-Konfiguration oder in einem vorgeschalteten Reverse-Proxy
Absturz oder Neustart des Audio-Dienstes (FreeSWITCH) oder des Medien-Dienstes (bbb-webrtc-sfu)
(Ab BBB 3.0) Probleme mit doppelten Reverse-Proxy-Ketten, die WebSocket-Header nicht korrekt weiterleiten

Lösungen

Für Teilnehmer

Seite neu laden: Drücken Sie F5 oder klicken Sie auf „Aktualisieren” in Ihrem Browser. In den meisten Fällen können Sie sich danach wieder mit Audio verbinden.
Audio erneut verbinden: Klicken Sie auf das Audio-Symbol in der unteren Leiste, um die Audioverbindung neu aufzubauen, ohne die ganze Seite neu zu laden.
Internetverbindung prüfen: Stellen Sie sicher, dass Ihre Verbindung stabil ist. Wechseln Sie nach Möglichkeit von WLAN auf eine Kabelverbindung (LAN).
VPN deaktivieren: Falls Sie ein VPN verwenden, deaktivieren Sie es testweise und treten Sie der Konferenz erneut bei.
Anderen Browser testen: Verwenden Sie einen aktuellen Browser wie Chrome, Firefox oder Edge. Veraltete Browser können Verbindungsprobleme verursachen.
Firmen-Firewall prüfen: Wenn der Fehler immer nach der gleichen Zeitspanne auftritt (z. B. exakt nach 5 Minuten), deutet das auf eine Firewall hin, die lang laufende Verbindungen kappt. Wenden Sie sich in diesem Fall an Ihre IT-Abteilung.

Für Administratoren

nginx-Timeout erhöhen: Stellen Sie sicher, dass die WebSocket-Proxy-Konfiguration ausreichend hohe Timeout-Werte hat. Setzen Sie proxy_read_timeout und proxy_send_timeout auf mindestens 86400s (24 Stunden) in der entsprechenden location-Direktive.
Reverse-Proxy-Kette prüfen: Falls ein externer Reverse-Proxy (HAProxy, Cloudflare, weiterer nginx) vor dem BBB-Server steht, müssen auch dort die Timeout-Werte hoch genug sein und die WebSocket-Upgrade-Header korrekt weitergeleitet werden.
Certbot-Reload überprüfen: Wenn alle Teilnehmer gleichzeitig getrennt werden, prüfen Sie, ob eine automatische Zertifikatserneuerung einen nginx-Reload ausgelöst hat.
Dienste prüfen: Kontrollieren Sie den Status der relevanten Dienste mit sudo bbb-conf --status und sudo bbb-conf --check.

Technische Details: Diagnose-Befehle für den Server

Folgende Befehle helfen bei der Fehlersuche auf dem Server:

# Allgemeine BBB-Prüfung
sudo bbb-conf --check
sudo bbb-conf --status

# Logs der relevanten Dienste in Echtzeit verfolgen
journalctl -u freeswitch.service -f
journalctl -u bbb-webrtc-sfu.service -f

# nginx-Fehlerlogs prüfen
sudo tail -100 /var/log/nginx/error.log

Für die nginx-WebSocket-Konfiguration in /etc/nginx/sites-available/bigbluebutton sollte der relevante location-Block so aussehen:

location /ws {
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
    proxy_set_header Host $host;
    proxy_read_timeout 86400s;
    proxy_send_timeout 86400s;
    proxy_buffering off;
}

Nach einer Änderung an der nginx-Konfiguration: Konfiguration testen und reloaden (nicht restarten, um bestehende Verbindungen zu erhalten):

sudo nginx -t && sudo nginx -s reload

Weitere Informationen

Verwandte Fehlercodes: Fehler 1002 tritt auf, wenn die WebSocket-Verbindung von Anfang an nicht hergestellt werden kann (im Gegensatz zu 1001, wo die Verbindung bereits bestand und dann abbricht). Fehler 1005 beschreibt einen unerwarteten Abbruch des Audio-Anrufs während der Sitzung.

Ab BBB 2.7 wird der WebSocket auch für den Echtzeit-Datenaustausch genutzt (GraphQL/Hasura). Ein Verbindungsabbruch ist daher in neueren Versionen spürbarer als in älteren, da neben dem Audio auch die gesamte Benutzeroberfläche betroffen sein kann.