bbb-hilfe.de

Deutsche Hilfeseite

Fehler 2202: Ungültige SDP-Sitzungsbeschreibung vom Client

Start  /  Docs  /  Fehler 2202: Ungültige SDP-Sitzungsbeschreibung vom Client
bbbserver.de ausprobieren
Print

Wenn Sie in BigBlueButton Audio oder Video starten möchten, kommuniziert Ihr Browser zunächst mit dem Medienserver, um eine Verbindung auszuhandeln. Dabei wird eine sogenannte SDP-Sitzungsbeschreibung (Session Description Protocol) ausgetauscht – ein strukturierter Text, der beschreibt, welche Codecs, Verschlüsselungsparameter und Verbindungsdaten Ihr Browser anbietet. Fehler 2202 tritt auf, wenn der Medienserver diese Beschreibung nicht verarbeiten kann, weil sie fehlerhaft oder unvollständig ist.

Wie äußert sich der Fehler?

Der Fehler erscheint in der Regel beim Versuch, dem Audio- oder Videobereich einer BigBlueButton-Sitzung beizutreten. Der Verbindungsaufbau schlägt fehl, und in den Browser-Entwicklertools oder den Serverprotokollen ist der Code 2202 bzw. der Schlüssel app.sfu.invalidSdp2202 zu finden. Für Teilnehmer äußert sich dies meist als hängendes Ladezeichen oder eine Fehlermeldung, dass die Verbindung nicht hergestellt werden konnte.

Mögliche Ursachen

  • Browser-Erweiterungen, die WebRTC verändern: Erweiterungen zur Bandbreitenkontrolle, Codec-Auswahl oder zum Schutz vor WebRTC-Lecks können die SDP-Beschreibung vor dem Absenden abändern und so ungültige Werte erzeugen. Typische Kandidaten sind WebRTC Control, WebRTC Leak Shield oder ähnliche Datenschutz-Add-ons.
  • Veralteter Browser: Sehr alte Browserversionen erzeugen SDP-Beschreibungen, die nicht den aktuellen WebRTC-Standards oder den Anforderungen des BBB-Medienservers (mediasoup ab BBB 2.5) entsprechen – etwa fehlendes a=extmap-allow-mixed oder eine falsche DTLS-Rolle.
  • Drittanbieter-Clients oder API-Integrationen: Wird BBB nicht über einen Standard-Browser, sondern über eine eigene Anwendung oder eine benutzerdefinierte WebRTC-Implementierung genutzt, kann die manuell erstellte SDP-Beschreibung Pflichtfelder auslassen oder nicht standardkonformes Format verwenden.
  • Codec-Konfigurationsfehler auf dem Server: Wenn in der BBB-Serverkonfiguration (production.yml) Codecs eingeschränkt wurden, der Browser aber noch die alten Codecs anbietet – oder umgekehrt –, kann mediasoup das Angebot ablehnen.
  • Versionsinkonsistenz in gemischten Umgebungen: In Umgebungen, in denen während eines Upgrades verschiedene BBB-Versionen gleichzeitig aktiv sind, kann es zu SDP-Inkompatibilitäten zwischen dem SFU-Server und dem Browser-Bundle kommen.

Lösungen

Für Teilnehmer

  1. Browser-Erweiterungen deaktivieren: Öffnen Sie ein privates Fenster (Inkognito-Modus) oder ein neues Browser-Profil ohne Erweiterungen und versuchen Sie erneut, der Sitzung beizutreten. Funktioniert es dort, liegt das Problem an einer installierten Erweiterung. Deaktivieren Sie Erweiterungen einzeln, um den Verursacher zu identifizieren – insbesondere solche, die WebRTC oder Netzwerkverbindungen beeinflussen.
  2. Browser aktualisieren: Stellen Sie sicher, dass Sie eine aktuelle Browserversion verwenden. BigBlueButton 2.5 und neuer (mit mediasoup) erfordert mindestens Chrome/Edge 74, Firefox 78 oder Safari 12.1. Prüfen Sie die Version unter chrome://settings/help (Chrome) bzw. about:support (Firefox) und installieren Sie verfügbare Updates.
  3. Anderen Browser ausprobieren: Falls das Problem in einem Browser anhält, testen Sie einen anderen (z. B. von Chrome zu Firefox wechseln). So lässt sich eingrenzen, ob das Problem browser-spezifisch ist.
  4. Browser-Cache leeren und Seite neu laden: Leeren Sie den Browser-Cache vollständig und laden Sie die BBB-Sitzungsseite neu. In seltenen Fällen können veraltete JavaScript-Dateien aus dem Cache eine fehlerhafte SDP-Erzeugung auslösen.

Für Administratoren

  1. SFU-Protokolle auf den genauen Fehler prüfen: Der SFU-Dienst protokolliert den abgelehnten SDP-Inhalt und den spezifischen Parserfehler. Suchen Sie in den Logs nach dem Kontext des Fehlers:
sudo journalctl -u bbb-webrtc-sfu -n 300 --no-pager | grep -i "sdp\|invalid\|parse\|2202"
  1. WebRTC-Debugging im Browser: Öffnen Sie chrome://webrtc-internals (Chrome) oder about:webrtc (Firefox), starten Sie eine BBB-Sitzung und prüfen Sie das SDP-Angebot unter RTCPeerConnection. Achten Sie auf fehlende a=fingerprint:-Zeilen, fehlende ICE-Zugangsdaten (a=ice-ufrag:, a=ice-pwd:) oder m=-Abschnitte mit Port 0.
  2. Codec-Konfiguration prüfen: Vergleichen Sie die in production.yml konfigurierten Codecs mit dem, was aktuelle Browser anbieten. Nach Konfigurationsänderungen muss der SFU-Dienst neu gestartet werden.
  3. System aktualisieren und Dienste neu starten: Bei anhaltenden Problemen nach einem BBB-Update helfen ein vollständiger Reset der BBB-Dienste sowie ein System-Update:
sudo apt-get update && sudo apt-get dist-upgrade
sudo bbb-conf --clean
sudo bbb-conf --check
  1. Für API-Integrationen und eigene Clients: Stellen Sie sicher, dass die erzeugte SDP die DTLS-Rolle actpass in Angeboten verwendet, die Attribute a=rtcp-mux und a=rtcp-rsize enthält, gültige SSRC-Zeilen mit cname hat und das Profil UDP/TLS/RTP/SAVPF (nicht das veraltete RTP/AVP) verwendet.

Weitere Informationen

Der Fehler 2202 tritt bei unveränderten Standard-Browsern sehr selten auf und deutet fast immer auf eine externe Einflussnahme hin – sei es durch Erweiterungen, veraltete Software oder eine benutzerdefinierte Integration. Ab BBB 2.5 mit mediasoup ist die SDP-Validierung strenger als in früheren Versionen mit Kurento, weshalb Probleme, die zuvor stillschweigend ignoriert wurden, nun als Fehler gemeldet werden.

Mobiler Hinweis auf bbbserver.de