RTSP Stream Troubleshooting: The Complete Diagnostic Guide for Camera Streams
Complete RTSP diagnostic workflow: connection layer, control plane errors (400/401/404/454/461/500/503), media plane failures (H.264/H.265/RTP/RTCP), session management, and comparison with Wireshark/VLC. Every RTSP problem mapped to a diagnostic page.
This is the hub page for RTSP camera stream diagnostics. Every RTSP problem follows a pattern — it fails at the connection layer, the control plane, or the media plane. This guide maps every common failure to a specific diagnostic page and tells you what evidence to collect.
Quick triage: where is the failure?
Before reading any specific page, determine which layer is failing:
- Can the client reach the camera? → Connection layer problems
- Does DESCRIBE return valid SDP? → Control plane problems
- Do RTP packets arrive and decode correctly? → Media plane problems
If you don't know which layer is failing, start with the systematic diagnostic workflow.
Connection layer: reaching the camera
These problems happen before any RTSP command is sent. TCP handshake fails, TLS negotiation fails, or the network path is blocked.
RTSP connects but no video — The most common symptom. Camera appears online but no media stream.
RTSP over TLS (RTSPS) debugging — TLS certificate errors, handshake failures, cipher suite negotiation.
Control plane: RTSP command errors
These are protocol-level errors returned by the camera in response to DESCRIBE, SETUP, or PLAY. The error code tells you exactly what went wrong.
400 Bad Request
- RTSP 400 Bad Request: DESCRIBE failed — Malformed URL, unsupported headers, proxy interference. Covers Axis, Dahua, and Hikvision URL formats.
401 Unauthorized
RTSP 401 authentication loop — Digest vs basic auth, nonce/realm parameters, why authentication succeeds in VLC but fails in your app.
RTSP digest authentication deep dive — Nonce expiration, realm matching, stale=true handling.
401/404 camera URL diagnostics — When the URL works in one client but not another.
404 Not Found
401/404 camera URL diagnostics — Wrong stream path, camera-specific URL formats.
Aggregate control URL and SDP SETUP 404 — When the control URL in SDP doesn't match the DESCRIBE URL.
454 Session Not Found
- RTSP 454 Session Not Found — Session ID mismatch, expired sessions, PLAY before SETUP.
461 Unsupported Transport
- RTSP 461 Unsupported Transport: SETUP failed — UDP vs TCP transport negotiation, ffmpeg "method SETUP failed: 461", Frigate/Scrypted/NVR integration errors.
500 / 503 Server Errors
RTSP 500 Internal Server Error — Camera-side failure. When to conclude the camera firmware is at fault.
RTSP 503 Service Unavailable — Camera resource exhaustion, too many concurrent streams, bandwidth limits.
Transport and networking
UDP RTP blocked by firewall/NAT — RTSP control works but UDP RTP media is blocked. Firewall rules, NAT traversal, RTSP protocol port configuration, TCP interleaved fallback.
TCP interleaved channel mismatch — When interleaved RTP/RTCP channels don't match between client and server.
Non-matching transport server reply — Server responds with different transport parameters than requested.
Multicast UDP debugging — Multicast RTSP/RTP configuration, IGMP, TTL, and network infrastructure.
RTSP timeout: UDP vs TCP interleaved — Why streams timeout differently on UDP vs TCP.
Media plane: RTP, codec, and payload problems
Control plane works perfectly — DESCRIBE returns SDP, SETUP succeeds, PLAY returns 200 OK — but video is broken. These are media plane problems.
RTP packet analysis
RTP dynamic payload type mismatch — "Unknown write" RTP/NDPI errors. How to map dynamic payload IDs to SDP rtpmap lines.
RTP packet loss diagnosis — RTP error in primary stream. Freezes, macroblocks, decoder errors. Read sequence numbers and RTCP reports to find the loss.
RTP timestamp drift — Audio/video sync loss, frame timing errors, clock rate mismatch.
RTP marker bit and frame boundaries — How the RTP marker bit signals H.264 access unit boundaries.
RTP sequence number wraparound — 16-bit sequence number rollover and how to detect actual loss vs wraparound.
RTP SSRC change mid-stream — When the camera changes SSRC mid-stream and the client loses sync.
H.264 and H.265 codec issues
H.264 FU-A fragmentation and reassembly — Missing fragments, start/end bit bugs, NAL unit reassembly failures, "invalid NAL unit" errors.
H.264 packetization mode 0 vs 1 — Single NAL vs non-interleaved mode. SDP parameter configuration.
H.264 SPS/PPS missing — Decoder errors when parameter sets are missing from SDP or RTP stream.
H.265 stream not working — H.265/HEVC failures and H.264 fallback behavior.
SDP H.264/H.265 diagnostics — Reading SDP for H.264/H.265: profile-level-id, sprop-parameter-sets, packetization-mode.
Audio and metadata tracks
- Audio track AAC unknown track SDP — AAC audio tracks appearing as "unknown" in clients.
ONVIF and camera-specific
ONVIF works but RTSP URL fails — ONVIF discovery succeeds but direct RTSP connection fails.
Main stream vs sub stream — When the main stream works but the sub stream doesn't, or vice versa.
RTCP and session management
RTCP sender reports: jitter and loss — Reading RTCP SR packets to understand network quality from the camera's perspective.
RTCP BYE: stream ends unexpectedly — When the camera sends RTCP BYE and terminates the stream.
RTCP CNAME and audio/video sync — Using RTCP CNAME to synchronize audio and video tracks.
RTSP TEARDOWN and session cleanup — Camera resource leaks, reconnect fails, busy stream state.
RTSP session timeout and keepalive — Why streams stop after ~30 seconds and how to keep them alive.
RTSP Range header and NPT — Controlling playback position with Range and NPT parameters.
RTSP Scale header and trick play — Fast-forward, rewind, and speed control via Scale header.
Comparison and alternatives
RTSP Inspector vs Wireshark/VLC/ONVIF Device Manager — When to use a dedicated RTSP diagnostic tool vs a general network analyzer.
Wireshark RTSP alternative — Why RTSP diagnostics need more than packet capture.
Getting started
New to RTSP diagnostics? Start here:
- Systematic diagnostic workflow — The three-layer model and evidence collection.
- Connect to a stream — Setting up your first RTSP connection.
- Troubleshooting guide — Common failures and their fixes.