2026-06-02

RTSP 400 不正なリクエストの修正: DESCRIBE の失敗、不正な形式のカメラ URL、およびヘッダーエラー

DESCRIBE の RTSP 400 Bad Request を修正。Axis/Dahua/Hikvision の不正な形式のカメラ URL、サポートされていないヘッダー、リバースプロキシの問題、認証、実際の診断コマンドを使用したベンダー固有のストリームパスをカバーします。

「RTSP/1.0 400 Bad Request」は、カメラが RTSP リクエストを不正な形式として拒否したことを意味します。ネットワークの問題ではありません。コーデックの問題ではありません。これはリクエスト形式の問題であり、カメラが受信した正確なリクエストを確認すれば修正可能です。

簡単な答え: 30 秒のトリアージ

最初に VLC でテストします。 VLC が動作する場合は、VLC が送信する正確な RTSP リクエストをキャプチャします。失敗したクライアントと比較してください。
URL パスを確認してください。 カメラが異なれば、同じ RTSP ストリームに対してまったく異なるパスが使用されます。あるカメラブランドから別のカメラブランドに URL をコピーすることが、400 エラーの最大の原因です。
Check URL encoding. Special characters in passwords break RTSP URL parsing. Encode @ as %40, : as %3A, / as %2F.
プロキシの干渉を確認してください。 カメラへの直接 RTSP は機能しますが、プロキシ経由では 400? が返されます。プロキシが RTSP ヘッダーを変更しています。

これらのいずれでも問題が解決しない場合は、以下の詳細なセクションを実行してください。

最初に: カメラが到達可能であることを確認します

RTSP をデバッグする前に、基本的な接続を確認します。

# 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

Camera-specific URL formats

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

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 -

# 正確な RTSP 交換を示す詳細な出力
ffmpeg -loglevel debug -rtsp_transport tcp -i "rtsp://..." -t 1 -f null - 2>&1 | grep -E "説明|設定|応答"

URL エンコード: サイレント 400 トリガー

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

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

リバースプロキシ: 隠れた 400 の原因

HTTP リバースプロキシを介した RTSP は脆弱です。 HTTP 用に設計されたプロキシでは、次のことが可能です。

HTTP 固有のヘッダー (Host、X-Forwarded-For、User-Agent) を挿入します。
リクエストURIを書き換える
TCP 接続動作をバッファリングして変更する
RTSP の永続的接続モデルを妨害する

プロキシ干渉の症状:

RTSP をカメラに直接送信: 機能します
プロキシ経由の RTSP: 400 Bad Request
カメラのログに、直接フローに存在しない余分なヘッダーを含む「不正なリクエスト」が表示される

修正: RTSP トラフィックのプロキシをバイパスするか、RTSP 対応プロキシを使用するか、または RTSP トラフィックを変更せずに渡すようにプロキシを構成します。

認証のエッジケース

ほとんどの認証問題は 401 を返しますが、不正な形式の Authorization ヘッダーは 400 を返す場合があります。

「最初の試行では機能し、再試行では失敗する」パターン:

クライアントが認証されていない DESCRIBE を送信する
カメラはダイジェストチャレンジ (レルム、ノンス) を含む 401 を返します
クライアントはダイジェスト応答を計算します
クライアントは、Authorization ヘッダーを含む認証された DESCRIBE を送信します
カメラは 400 を返します

これは、ダイジェスト応答の計算が間違っている場合に発生します。つまり、ダイジェストの計算で使用された URI が実際のリクエスト URI と一致しないか、ノンスが古いか、パスワード内の特殊文字がハッシュ化前に正しくエンコードされていなかった場合に発生します。

確認: Authorization ヘッダー内のリクエスト URI を、回線上の実際のリクエスト URI と比較します。ダイジェスト認証では、URI はハッシュの一部です。文字ごとに一致しない場合 (エンコーディングを含む)、応答は無効になります。

カメラが壊れたばかりのとき

一部のカメラにはバグのある RTSP 実装があります。上記をすべて確認しても 400 が得られる場合:

ファームウェアのアップデートを確認する
メーカー独自のクライアントソフトウェアでテストする
代替の検出およびストリーミングパスとして ONVIF を試してください
カメラが独自のアプリでは動作するが、標準に準拠した RTSP クライアントでは動作しない場合、カメラの RTSP スタックは非準拠です。

カメラのベンダーにバグを報告してください。正確な RTSP DESCRIBE リクエストとレスポンスを含めます。適切な RTSP 実装では、URL パスに関係なく、有効で整形式のリクエストに対して 400 を返すことはなく、404 を返す必要があります。

「RTSP 400 不正なリクエストの修正: DESCRIBE の失敗、不正な形式のカメラ URL、およびヘッダーエラー」を再現可能に検証する手順

結論から言うと、黒画面や一つのステータスコードだけでは障害の所在を証明できません。信頼できる診断では、RTSP の要求と応答、合意した Transport、有効な Session、その後の RTP シーケンス番号、タイムスタンプ、RTCP の証拠を一つの時系列につなげます。「RTSP 400 不正なリクエストの修正: DESCRIBE の失敗、不正な形式のカメラ URL、およびヘッダーエラー」では表示症状に近い層から調べますが、制御、ネットワーク、デコーダーの問題を混同しないよう同じ記録時刻を使います。

カメラ、ファイアウォール、VMS の設定を変える前に、小さな基準テストを作ります。パスワードを除いた RTSP URL、時刻、パス、要求した Transport、サーバー応答、最初のメディアパケット到着時刻を記録してください。機器が対応する場合は UDP と TCP interleaved を別々に試します。パス、認証情報、Transport を同時に変えると、二回目の成功がどの変更によるものか分かりません。

確認層	保存する証拠	判断する質問
RTSP	メソッド、状態、ヘッダー、CSeq、Session	サーバーはその操作を受理したか
SDP	control、payload type、clock rate、codec	期待するトラックが記述されているか
Transport	client_port、server_port、interleaved	両端が同じ経路を使うか
RTP	SSRC、sequence、timestamp、marker	メディア単位が説明可能な順序で届くか
RTCP	sender report、CNAME、BYE	時計、識別子、終了を追跡できるか
Decoder	SPS/PPS/VPS、packetization mode	受信 payload で初期化できるか

「メディアが届かない」と「届くが復号できない」を分けます。SETUP と PLAY が成功しても RTP がなければ、UDP 経路、NAT、ファイアウォール、Transport 応答を調べます。シーケンスの穴は損失または並べ替えを示します。連続した RTP があるのに映像がなければ、payload type、clock rate、フレーム境界、H.264 または H.265 のパラメーターへ進みます。この境界はプレーヤーの一般的なエラーより有用です。

引用できる短い回答はどう書きますか

三文で、最後に成功した操作、最初に失敗した証拠、二つの原因を分ける次の試験を書きます。例は「DESCRIBE、SETUP、PLAY は成功した。通知されたクライアントポートに RTP が届かない。TCP interleaved の再試験で UDP 遮断とメディアパス誤りを分ける」です。応答やパケットなしにカメラやネットワーク全体を原因と断定しません。

再現に必要な最小情報は何ですか

OPTIONS、DESCRIBE、SETUP、PLAY、SDP、Transport 応答、秘密を除いた Session を保存します。RTP は SSRC、最初と最後のシーケンス、clock rate、欠落数、収録時間を記録します。VLC や別 VMS の成否は差分試験として有用ですが、成功したクライアントが全規則を正しく扱う証明ではありません。

サーバーとクライアントのどちらを調べますか

メソッド拒否、存在しない control URL、不一致 Transport、説明のない SSRC や時計変更はサーバー側を調べます。期限切れ nonce の再利用、Session 欠落、ポートを開かない UDP 要求、各 NAL 終端を access unit 終端とみなす処理はクライアント側を調べます。中間経路の問題では、各結論にパケットと時刻を添えます。

報告前に何を確認しますか

新しい接続で再試験し、二つの時系列を最初の相違点まで比較します。パスワードと完全な Authorization 値を削除し、結論を CSeq、sequence、timestamp に結び付けます。関連する RTSP ガイドで周辺手順を確認し、RTSP Inspectorで RTSP ストリームをローカルに試験してください。カメラ映像を公開サービスへアップロードする必要はありません。

観測から層ごとの判定へ

「RTSP 400 不正なリクエストの修正: DESCRIBE の失敗、不正な形式のカメラ URL、およびヘッダーエラー」では解釈より先に観測を書きます。観測は別の担当者が記録から見つけられるものです。CSeq に結び付いた RTSP 状態、SDP 値、Transport 応答、連続番号の穴、SSRC 変更、RTP timestamp と RTCP sender report の差などが該当します。「サーバーが遅い」「コーデック非互換」は、具体的な証拠が他の原因より強く支持するまで仮説です。

処理を境界に分けます。TCP 接続、OPTIONS または DESCRIBE の受理、利用可能な SDP の track・control URL・payload type・clock rate、互換性のある SETUP 応答、有効な Session を伴う PLAY を順に確認します。その後に RTP 到着、順序、時刻、デコーダー準備を調べます。成功証拠のない最初の境界で止まり、後段の情報で前段の欠落を隠しません。

比較では原音と時間範囲を固定します。UDP と TCP interleaved は同じパスと認証情報で試します。main stream と sub stream は同じクライアントと Transport を使います。VLC と VMS の比較では実際のメソッド、ヘッダー、URL を記録してください。control URL、Authorization、Session、keepalive の違いが製品名より結果を説明する場合があります。

除外マトリクス

仮説は二つから始めます。メディアがない場合、UDP 遮断または別ポートへの送信を考えます。TCP interleaved は前者、Transport の提案と応答、IP、ポート比較は後者を試験します。映像破損では RTP sequence がパケット損失と初期化不足を分け、最初の frame 前の SPS/PPS/VPS が codec パラメーター仮説を試験します。

各仮説に支持証拠と反証可能な証拠を書きます。どのパケットでも否定できない主張は広すぎます。「NAT が UDP を捨てる」はクライアントポートへの RTP 到着で否定できます。「H.264 パラメーターがない」は IDR 前の有効な SPS/PPS で否定できます。これにより報告が可能性一覧ではなく優先順位付き判断になります。

時刻を混同しない

RTSP CSeq は制御取引、RTP sequence はパケット順、RTP timestamp はメディア標本時刻、capture clock は観測点への到着を表します。同じ時計ではありません。到着揺れだけでは timestamp drift を証明できず、sequence 証拠のない timestamp 跳躍だけでは損失を証明できません。音声と映像は RTCP sender report で共通基準へ関連付けます。

合格資料

新しい接続で一つの変更を再現できた時に調査を閉じます。入力、最後の成功境界、最初の失敗証拠、変更、再試験結果、未試験事項を書きます。巨大なファイルではなく短い transcript または統計を添えます。秘密は消しますが、CSeq、脱敏した Session、SSRC、時間範囲は残します。

RTSP トラブルシューティングで順序を再確認し、RTSP Inspector レポートでカメラ、ネットワーク、VMS の担当へ証拠境界を渡せます。