2026-06-02

RTSP 400 Bad Request Fix: DESCRIBE fehlgeschlagen, fehlerhafte Kamera-URL und Header-Fehler

RTSP 400 Bad Request bei DESCRIBE beheben. Deckt fehlerhafte Kamera-URLs für Axis/Dahua/Hikvision, nicht unterstützte Header, Reverse-Proxy-Probleme, Authentifizierung und herstellerspezifische Stream-Pfade mit echten Diagnosebefehlen ab.

„RTSP/1.0 400 Bad Request“ bedeutet, dass die Kamera Ihre RTSP-Anfrage als fehlerhaft abgelehnt hat. Es ist kein Netzwerkproblem. Es ist kein Codec-Problem. Es handelt sich um ein Problem mit dem Anforderungsformat – und es kann behoben werden, sobald Sie die genaue Anforderung sehen, die die Kamera erhalten hat.

Schnelle Antwort: 30-Sekunden-Triage

Zuerst mit VLC testen. Wenn VLC funktioniert, erfassen Sie die genaue RTSP-Anfrage, die es sendet. Vergleichen Sie es mit Ihrem scheiternden Kunden.
Überprüfen Sie den URL-Pfad. Verschiedene Kameras verwenden völlig unterschiedliche Pfade für denselben RTSP-Stream. Das Kopieren einer URL von einer Kameramarke zu einer anderen ist die häufigste Ursache für 400 Fehler.
Check URL encoding. Special characters in passwords break RTSP URL parsing. Encode @ as %40, : as %3A, / as %2F.
Auf Proxy-Störungen prüfen. Direktes RTSP zur Kamera funktioniert, aber über einen Proxy werden 400 zurückgegeben? Der Proxy ändert RTSP-Header.

Wenn keine dieser Maßnahmen das Problem behebt, arbeiten Sie die folgenden detaillierten Abschnitte durch.

Stellen Sie zunächst sicher, dass die Kamera erreichbar ist

Überprüfen Sie vor dem Debuggen von RTSP die grundlegende Konnektivität:

# TCP reachability
nc -zv 192.168.1.100 554

# Or with telnet
telnet 192.168.1.100 554

# RTSP OPTIONS — the simplest RTSP request
# If this fails, the camera isn't speaking RTSP

If the port is closed, the problem is network/firewall, not RTSP.

Camera-specific URL formats

The most common cause of 400 errors: using the wrong URL path format for your camera brand. Each manufacturer uses different conventions:

Axis

rtsp://<ip>/axis-media/media.amp
rtsp://<ip>/mpeg4/media.amp
rtsp://<ip>:554/axis-media/media.amp?videocodec=h264

Dahua

rtsp://<user>:<pass>@<ip>:554/cam/realmonitor?channel=1&subtype=0
rtsp://<user>:<pass>@<ip>:554/cam/realmonitor?channel=1&subtype=1

subtype=0: main stream
subtype=1: sub stream

Hikvision

rtsp://<user>:<pass>@<ip>:554/Streaming/Channels/101
rtsp://<user>:<pass>@<ip>:554/Streaming/Channels/102

101: channel 1, main stream
102: channel 1, sub stream
201: channel 2, main stream

Generic / ONVIF

rtsp://<ip>:554/stream1
rtsp://<ip>:554/live
rtsp://<ip>:554/h264
rtsp://<ip>:554/h265
rtsp://<ip>:554/profile1/media.smp
rtsp://<ip>/onvif1
rtsp://<ip>/onvif2

Testing with ffmpeg

# Test DESCRIBE only (don't decode)
ffmpeg -rtsp_transport tcp -i "rtsp://user:pass@192.168.1.100:554/stream1" -t 1 -f null -

# Die ausführliche Ausgabe zeigt den genauen RTSP-Austausch
ffmpeg -loglevel debug -rtsp_transport tcp -i "rtsp://..." -t 1 -f null - 2>&1 | grep -E "DESCRIBE|SETUP|response"

URL-Kodierung: der stille 400-Trigger

When a password contains special characters, the RTSP URL becomes ambiguous. The @ separates credentials from the host, so a password containing @ breaks the parsing.

WRONG: rtsp://admin:pa@ss@192.168.1.100/stream1
       parser sees: user=admin, pass=pa, host=ss@192.168.1.100

RIGHT:  rtsp://admin:pa%40ss@192.168.1.100/stream1
       parser sees: user=admin, pass=pa@ss, host=192.168.1.100

Characters that must be encoded in RTSP URLs:

Character	Encoding	Example
`@`	`%40`	`user@domain` → `user%40domain`
`:`	`%3A`	`pass:word` → `pass%3Aword`
`/`	`%2F`	`pass/word` → `pass%2Fword`
`?`	`%3F`	in query values
`#`	`%23`	in query values
`%`	`%25`	literal percent
`&`	`%26`	in query values (if not separating parameters)
space	`%20`	in query values

Config files often add another layer of escaping. A URL in a YAML file may need both YAML escaping AND URL encoding.

Full diagnostic decision tree

RTSP returns 400 Bad Request
│
├─ Is port 554 reachable?
│  ├─ NO → Fix network/firewall. Not an RTSP issue.
│  └─ YES → Continue
│
├─ Does VLC play the same URL?
│  ├─ YES, VLC works → Capture VLC's exact request. Compare with your client.
│  │   Differences in headers, URI format, or auth will point to the fix.
│  └─ NO, VLC also fails → Problem is in the URL or camera config
│
├─ Check the URL path
│  ├─ Wrong manufacturer format → Use correct format for your camera brand
│  ├─ Query parameters missing → Add required parameters (channel, subtype)
│  └─ Path contains unencoded special chars → URL-encode credentials
│
├─ Check DESCRIBE headers
│  ├─ Missing Accept: application/sdp → Add it
│  ├─ Extra HTTP headers (via proxy) → Remove proxy from RTSP path
│  └─ Malformed Authorization → Fix Digest auth parameters
│
├─ Check CSeq and RTSP syntax
│  ├─ Missing CSeq → Add sequential CSeq header
│  ├─ Wrong RTSP version → Use RTSP/1.0
│  └─ CRLF formatting wrong → Ensure \r\n line endings
│
└─ Still failing?
   ├─ Try ONVIF discovery to get the correct RTSP URL
   ├─ Check camera firmware version (older firmware may have stricter parsing)
   └─ Test with a known-working RTSP client as baseline

Reverse-Proxy: die versteckte 400-Ursache

RTSP über einen HTTP-Reverse-Proxy ist fragil. Für HTTP entwickelte Proxys können:

HTTP-spezifische Header einfügen (Host, X-Forwarded-For, User-Agent)
Schreiben Sie den Anforderungs-URI neu
Puffern und ändern Sie das TCP-Verbindungsverhalten
Beeinträchtigung des dauerhaften Verbindungsmodells von RTSP

Symptome einer Proxy-Interferenz:

RTSP direkt an die Kamera senden: funktioniert
RTSP über Proxy: 400 Bad Request – Kameraprotokolle zeigen „fehlerhafte Anfrage“ mit zusätzlichen Headern, die im direkten Fluss nicht vorhanden sind

Fix: Umgehen Sie entweder den Proxy für RTSP-Verkehr, verwenden Sie einen RTSP-fähigen Proxy oder konfigurieren Sie den Proxy so, dass er den RTSP-Verkehr unverändert weiterleitet.

Randfälle der Authentifizierung

Die meisten Authentifizierungsprobleme geben 401 zurück, aber ein fehlerhafter Autorisierungsheader kann 400 zurückgeben.

Das Muster „funktioniert beim ersten Versuch, schlägt beim erneuten Versuch fehl“:

Der Client sendet unauthentifiziertes DESCRIBE
Kamera gibt 401 mit Digest-Challenge zurück (Realm, Nonce)
Der Client berechnet die Digest-Antwort
Der Client sendet authentifiziertes DESCRIBE mit Autorisierungsheader
Die Kamera gibt 400 zurück

Dies geschieht, wenn die Berechnung der Digest-Antwort falsch ist – der in der Digest-Berechnung verwendete URI stimmt nicht mit dem tatsächlichen Anforderungs-URI überein, die Nonce war veraltet oder Sonderzeichen im Passwort wurden vor dem Hashing nicht korrekt codiert.

Prüfen: Vergleichen Sie den Anforderungs-URI im Authorization-Header mit dem tatsächlichen Anforderungs-URI auf der Leitung. Bei der Digest-Authentifizierung ist der URI Teil des Hashs – wenn sie nicht zeichenweise (einschließlich Codierung) übereinstimmen, ist die Antwort ungültig.

Wenn die Kamera einfach kaputt ist

Einige Kameras verfügen über fehlerhafte RTSP-Implementierungen. Wenn Sie alles oben überprüft haben und immer noch 400 erhalten:

Suchen Sie nach Firmware-Updates
Testen Sie mit der herstellereigenen Client-Software
Probieren Sie ONVIF als alternativen Erkennungs- und Streaming-Pfad aus
Wenn die Kamera mit ihrer eigenen App, aber nicht mit standardkonformen RTSP-Clients funktioniert, ist der RTSP-Stack der Kamera nicht konform

Melden Sie einen Fehler beim Kamerahersteller. Geben Sie die genaue RTSP DESCRIBE-Anfrage und -Antwort an. Eine ordnungsgemäße RTSP-Implementierung sollte für eine gültige, wohlgeformte Anfrage unabhängig vom URL-Pfad nicht 400 zurückgeben, sondern 404.

Reproduzierbarer Nachweis für „RTSP 400 Bad Request Fix: DESCRIBE fehlgeschlagen, fehlerhafte Kamera-URL und Header-Fehler“

Die direkte Antwort lautet: Eine Kamerastream-Störung wird nicht durch ein einzelnes Player-Fenster oder einen Statuscode bewiesen. Die belastbare Diagnose verbindet RTSP-Anfrage und Antwort, die ausgehandelte Transportart, eine gültige Session und anschließend RTP-Sequenznummern, Zeitstempel sowie RTCP-Belege. Beginnen Sie bei „RTSP 400 Bad Request Fix: DESCRIBE fehlgeschlagen, fehlerhafte Kamera-URL und Header-Fehler“ an der Schicht, die dem sichtbaren Symptom am nächsten liegt, behalten Sie aber eine gemeinsame Zeitleiste, damit Steuerungs-, Netzwerk- und Decoderfehler nicht vermischt werden.

Erstellen Sie vor Änderungen an Kamera, Firewall oder VMS einen kleinen Ausgangstest. Notieren Sie die bereinigte RTSP-URL, Uhrzeit, Pfad, angeforderten Transport, Serverantwort und den Zeitpunkt des ersten Medienpakets. Testen Sie UDP und TCP interleaved getrennt, sofern das Gerät beides anbietet. Ändern Sie nicht gleichzeitig Pfad, Zugangsdaten und Transport. Sonst zeigt ein erfolgreicher zweiter Versuch nicht, welche Variable den Fehler beseitigt hat.

Prüfschicht	Zu sichernder Nachweis	Entscheidungsfrage
RTSP	Methode, Status, Header, CSeq und Session	Hat der Server genau diese Operation akzeptiert?
SDP	control, Payload-Typ, Clock Rate und Codec	Beschreibt der Server den erwarteten Medientrack?
Transport	client_port, server_port oder interleaved	Verwenden beide Seiten denselben Kanal?
RTP	SSRC, Sequenz, Timestamp und Marker	Kommen Medieneinheiten in erklärbarer Reihenfolge an?
RTCP	Sender Report, CNAME und BYE	Sind Uhr, Identität und Sitzungsende nachvollziehbar?
Decoder	SPS/PPS/VPS und Packetization Mode	Lassen sich die angekommenen Nutzdaten initialisieren?

Trennen Sie „keine Medien angekommen“ von „Medien angekommen, aber nicht decodierbar“. Fehlt RTP nach erfolgreichem SETUP und PLAY, prüfen Sie UDP-Pfad, NAT, Firewall und einen abweichenden Transport-Reply. RTP mit Sequenzlücken belegt Verlust oder Reordering. Eine lückenlose Folge ohne Bild verschiebt die Prüfung auf Payload-Typ, Clock Rate, Frame-Grenzen und H.264-/H.265-Parameter. Diese Grenze ist aussagekräftiger als eine allgemeine Player-Meldung.

Wie formuliert man eine zitierfähige Kurzantwort?

Nennen Sie in drei Sätzen die letzte erfolgreiche Operation, den ersten fehlgeschlagenen Beleg und den nächsten trennenden Test. Beispielstruktur: „DESCRIBE, SETUP und PLAY waren erfolgreich. An den angekündigten Client-Ports kam kein RTP an. Ein Test über TCP interleaved trennt UDP-Blockierung von einem falschen Medienpfad.“ Behaupten Sie keinen Kamera- oder Netzwerkdefekt ohne passende Antwort oder Paketbeleg.

Welche Angaben machen den Fehler reproduzierbar?

Sichern Sie OPTIONS, DESCRIBE, SETUP und PLAY samt SDP, Transport-Antwort und bereinigter Session-ID. Für Medien genügen zunächst SSRC, erste und letzte Sequenznummer, Clock Rate, Lückenanzahl und Aufnahmedauer. Vermerken Sie, ob VLC oder ein anderes VMS funktioniert. Das ist ein Differenztest, aber kein Beweis, dass der erfolgreiche Client jede Protokollgrenze korrekt behandelt.

Wann liegt der nächste Test auf Server- oder Clientseite?

Prüfen Sie den Server, wenn er eine Methode klar ablehnt, einen nicht vorhandenen control-Pfad liefert, das Transportangebot widersprüchlich beantwortet oder SSRC beziehungsweise Clock Rate ohne erklärten Übergang wechselt. Prüfen Sie den Client, wenn er einen alten Nonce wiederverwendet, Session-Header verliert, UDP anfordert ohne Ports zu öffnen oder jedes NAL-Ende als Access-Unit-Ende behandelt. Für Zwischenfehler bleiben Zeitstempel und Paketfolge unverzichtbar.

Wie wird der Bericht vor der Übergabe geprüft?

Wiederholen Sie den Test mit einer frischen Verbindung und vergleichen Sie beide Abläufe nur bis zur ersten Abweichung. Entfernen Sie Passwörter und vollständige Authorization-Werte. Verknüpfen Sie jede Aussage mit CSeq, Sequenznummer oder Timestamp. Der passende RTSP-Leitfaden erklärt angrenzende Schritte; RTSP Inspector dient als lokaler Arbeitsbereich zum Testen eines RTSP-Streams und zum Sammeln der Belege, ohne den Kamerastream zu einem öffentlichen Dienst hochzuladen.

Direkte Antwort und Abnahmegrenze

Die kurze Antwort zu „RTSP 400 Bad Request Fix: DESCRIBE fehlgeschlagen, fehlerhafte Kamera-URL und Header-Fehler“ lautet: RTSP 400 Bad Request bei DESCRIBE beheben. Deckt fehlerhafte Kamera-URLs für Axis/Dahua/Hikvision, nicht unterstützte Header, Reverse-Proxy-Probleme, Authentifizierung und herstellerspezifische Stream-Pfade mit echten Diagnosebefehlen ab. Behandeln Sie diese Aussage als zu prüfendes Ergebnis und nicht als Versprechen für jede Eingabe, jedes Gerät, jedes Projekt oder jede Umgebung. Ein vollständiges Ergebnis dokumentiert Ausgangszustand, exakte Aktion, sichtbare Ausgabe und die Bedingung, die den Abschluss in RTSP Inspector belegt.

Evidenzorientiertes Vorgehen

Beginnen Sie mit einem kleinen, wiederholbaren Fall, bevor Sie ein vollständiges Projekt verändern. Protokollieren Sie Anwendungsversion, Betriebssystem, Eingabe- oder Geräteidentität, relevante Einstellungen und erwartetes Ergebnis. Führen Sie eine bewusste Aktion aus, bewahren Sie den ersten unerwarteten Übergang und vergleichen Sie möglichst mit einem bekannten guten Lauf. Mehrere gleichzeitige Änderungen verdecken, welche Bedingung den Fehler erzeugt oder behoben hat.

Prüfpunkt 1: RTSP 400 Bad Request Fix: DESCRIBE fehlgeschlagen, fehlerhafte Kamera-URL und Header-Fehle

Trennen Sie bei „RTSP 400 Bad Request Fix: DESCRIBE fehlgeschlagen, fehlerhafte Kamera-URL und Header-Fehler“ eine Produktentscheidung von Grenzen des Betriebssystems, der Hardware, Quelldatei, Berechtigung oder Arbeitsweise. Bestätigen Sie zuerst, welche Schicht die Evidenz geliefert hat. So wird ein benachbartes Symptom nicht fälschlich zur bewiesenen Ursache.

Prüfpunkt 2: RTSP 400 Bad Request bei DESCRIBE beheben. Deckt fehlerhafte Kamera-URLs für Axis/Dahua/Hi

Schließen Sie „RTSP 400 Bad Request bei DESCRIBE beheben. Deckt fehlerhafte Kamera-URLs für Axis/Dahua/Hikvision, nicht unterstützte Header, Reverse-Proxy-Probleme, “ erst, wenn gespeichertes, exportiertes oder erneut geöffnetes Ergebnis weiterhin dem beobachteten Zustand entspricht. Vorübergehendes UI-Feedback hilft, dauerhafte Evidenz ist aber stärker. Dokumentieren Sie verbleibende Grenzen für die nächste Person.

Prüfpunkt 3: Schnelle Antwort: 30-Sekunden-Triage

Trennen Sie bei „Schnelle Antwort: 30-Sekunden-Triage“ eine Produktentscheidung von Grenzen des Betriebssystems, der Hardware, Quelldatei, Berechtigung oder Arbeitsweise. Bestätigen Sie zuerst, welche Schicht die Evidenz geliefert hat. So wird ein benachbartes Symptom nicht fälschlich zur bewiesenen Ursache.

Prüfpunkt 4: Stellen Sie zunächst sicher, dass die Kamera erreichbar ist

Schließen Sie „Stellen Sie zunächst sicher, dass die Kamera erreichbar ist“ erst, wenn gespeichertes, exportiertes oder erneut geöffnetes Ergebnis weiterhin dem beobachteten Zustand entspricht. Vorübergehendes UI-Feedback hilft, dauerhafte Evidenz ist aber stärker. Dokumentieren Sie verbleibende Grenzen für die nächste Person.

Prüfpunkt 5: Camera-specific URL formats

Trennen Sie bei „Camera-specific URL formats“ eine Produktentscheidung von Grenzen des Betriebssystems, der Hardware, Quelldatei, Berechtigung oder Arbeitsweise. Bestätigen Sie zuerst, welche Schicht die Evidenz geliefert hat. So wird ein benachbartes Symptom nicht fälschlich zur bewiesenen Ursache.

Prüfpunkt 6: Axis

Schließen Sie „Axis“ erst, wenn gespeichertes, exportiertes oder erneut geöffnetes Ergebnis weiterhin dem beobachteten Zustand entspricht. Vorübergehendes UI-Feedback hilft, dauerhafte Evidenz ist aber stärker. Dokumentieren Sie verbleibende Grenzen für die nächste Person.

Prüfpunkt 7: Dahua

Trennen Sie bei „Dahua“ eine Produktentscheidung von Grenzen des Betriebssystems, der Hardware, Quelldatei, Berechtigung oder Arbeitsweise. Bestätigen Sie zuerst, welche Schicht die Evidenz geliefert hat. So wird ein benachbartes Symptom nicht fälschlich zur bewiesenen Ursache.

Prüfpunkt 8: Hikvision

Schließen Sie „Hikvision“ erst, wenn gespeichertes, exportiertes oder erneut geöffnetes Ergebnis weiterhin dem beobachteten Zustand entspricht. Vorübergehendes UI-Feedback hilft, dauerhafte Evidenz ist aber stärker. Dokumentieren Sie verbleibende Grenzen für die nächste Person.

Prüfpunkt 9: Generic / ONVIF

Trennen Sie bei „Generic / ONVIF“ eine Produktentscheidung von Grenzen des Betriebssystems, der Hardware, Quelldatei, Berechtigung oder Arbeitsweise. Bestätigen Sie zuerst, welche Schicht die Evidenz geliefert hat. So wird ein benachbartes Symptom nicht fälschlich zur bewiesenen Ursache.

Prüfpunkt 10: Testing with ffmpeg

Schließen Sie „Testing with ffmpeg“ erst, wenn gespeichertes, exportiertes oder erneut geöffnetes Ergebnis weiterhin dem beobachteten Zustand entspricht. Vorübergehendes UI-Feedback hilft, dauerhafte Evidenz ist aber stärker. Dokumentieren Sie verbleibende Grenzen für die nächste Person.

Abnahmematrix

Prüfpunkt	Aufzubewahrender Nachweis	Passkriterium
RTSP 400 Bad Request Fix: DESCRIBE fehlgeschlagen, fehlerhafte Kamera-URL und Header-Fehler	Ausgangszustand, eine Aktion und Ergebniszustand	Eine zweite Person kann das Ergebnis reproduzieren
RTSP 400 Bad Request bei DESCRIBE beheben. Deckt fehlerhafte Kamera-URLs für Axis/Dahua/Hikvision, nicht unterstützte He	Ausgangszustand, eine Aktion und Ergebniszustand	Eine zweite Person kann das Ergebnis reproduzieren
Schnelle Antwort: 30-Sekunden-Triage	Ausgangszustand, eine Aktion und Ergebniszustand	Eine zweite Person kann das Ergebnis reproduzieren
Stellen Sie zunächst sicher, dass die Kamera erreichbar ist	Ausgangszustand, eine Aktion und Ergebniszustand	Eine zweite Person kann das Ergebnis reproduzieren
Camera-specific URL formats	Ausgangszustand, eine Aktion und Ergebniszustand	Eine zweite Person kann das Ergebnis reproduzieren
Axis	Ausgangszustand, eine Aktion und Ergebniszustand	Eine zweite Person kann das Ergebnis reproduzieren

Fehlerisolierung, Recovery und Übergabe

Stoppen Sie beim ersten fehlerhaften Übergang. Bewahren Sie Quelle, Projekt, Session oder Capture und erstellen Sie vor destruktiven Änderungen eine Kopie. Ändern Sie pro Experiment nur eine Variable. Ein kompletter erneuter Lauf nach mehreren Änderungen kann anders enden, ohne die Ursache zu erklären.

Unterscheiden Sie fehlende Evidenz von Evidenz für ein Fehlen. Eine leere Ansicht kann auf falsche Eingabe, Scope, Filter, Berechtigung, Gerät, Zeitbereich oder Projektzustand hinweisen. Beweisen Sie Aufnahme oder Import, bevor Sie Decoder, Editor, Bericht oder Export interpretieren.

Öffnen Sie vor der Übergabe das dauerhafte Artefakt erneut und prüfen Sie Anfang, Entscheidungsstelle und Ende. Dokumentieren Sie Version, Plattform, Konfiguration, Erwartung, Beobachtung und kleinste Reproduktion. Entfernen oder schwärzen Sie sensible Daten und prüfen Sie die Berechtigung des Empfängers.

Fragen und Antworten

Wie beginnt man am schnellsten zuverlässig?

Verwenden Sie den kleinsten repräsentativen Fall, notieren Sie das erwartete Ergebnis und ändern Sie nur eine Variable. Beweisen Sie den Grundpfad, bevor Filter, Effekte, Bearbeitungen, Automatisierung oder größere Quellen hinzukommen.

Welche Evidenz sollte gespeichert werden?

Bewahren Sie Eingabeidentität, Version, Plattform, Einstellungen, exakte Aktion, ersten unerwarteten Übergang und Endausgabe. Projekt, Session, Bericht oder Export müssen geschlossen und erneut geöffnet werden.

Wann sollte das Verfahren wiederholt werden?

Wiederholen Sie es nach relevanten Änderungen an Anwendung, Betriebssystem, Treiber, Firmware, Modell, Quelle oder Workflow. Behalten Sie den früher akzeptierten Fall als unveränderte Vergleichsbasis.

Wann ist die Aufgabe übergabefähig?

Wenn eine autorisierte zweite Person Eingabe und Aktion erkennt, dasselbe Ergebnis reproduziert, verbleibende Grenzen versteht und das gespeicherte Artefakt ohne undokumentierten lokalen Zustand öffnen kann.