どの段階で止まるかを見る
curlの詳細表示は、名前解決、接続、TLS、送信要求、HTTP応答などを追う入口です。HTTPの500と、HTTP応答へ届く前の接続失敗は原因の段階が違います。まずURL、方式、時刻、プロキシの有無、curlの版を保存します。ブラウザと違う認証、Cookie、ヘッダー、HTTP版で試せば、成功しても同じ要求を再現したとは限りません。診断の最初は変更する条件を少なくし、対象の要求がどの通信段階まで進んだかを記録します。一回の成功から、全ての地域や利用者の経路が正常だと一般化しないようにします。
本文を保存せず一要求を記録する
例はverboseを有効にし、接続と全体の時間上限を設け、本文を/dev/nullへ捨てます。verboseの出力は通常標準エラー側なので、保存する場合は本文の出力と混同しません。認証情報やCookieを含む要求を記録するときは、共有するログへ機密が残らないよう範囲を選びます。ここではexample.comへ通常のGETを行う手順で、現在の応答を実測として掲載していません。HEADの-Iは本文を取得しない別方式であり、GETと同じ経路や処理を必ず通るわけではありません。本文が不要という理由だけで方式を変えた比較を同じ実験としないことが大切です。
curl --verbose --connect-timeout 3 --max-time 10 \
--output /dev/null https://example.com/終了コードとHTTP状態を分ける
curlの終了コードとHTTP状態コードは別です。既定ではHTTP404や500を受信しても、転送として成功したため終了コードがゼロになる場合があります。HTTPエラーも失敗として扱いたいなら、対応するfail系オプションの意味と版を確認します。逆に終了コードが非ゼロでも、相手側の業務操作が一切行われなかったとは言えません。応答を受け取れなかっただけの可能性があります。詳細出力では、名前解決、TCP接続、証明書検証、応答ヘッダーのどこまで進んだかを読み、終了コードだけでアプリやDBの結果まで決めつけないようにします。
接続先を変える比較を限定する
DNSの影響を切り分ける比較では、--resolveで特定のホスト名とポートに使うアドレスを指定できます。URLのホスト名を維持すれば、その名前に対するSNIや証明書検証を保った比較を作りやすくなりますが、プロキシや接続再利用など実際の経路も確認します。単にURLをIPへ変えると、仮想ホストや証明書の条件まで変える場合があります。-kで検証を無効にした成功を正常なTLSの証拠にしません。リダイレクトを追う場合は、最初の応答と到達先を分け、認証や要求方式がどう変わるかも確認して、意図しない条件変更を避けます。
時間と利用者経路を合わせて検証する
write-outの時間には、名前解決、接続、最初の応答、全体などの観点があります。値は累積時刻や接続再利用、プロキシの影響を受けるため、全てを独立した処理時間として足したり、常に単純な差分でサーバー処理だけを測れたと説明したりしません。初回と再利用時、成功と失敗を分け、アプリのログやトレースと合わせます。修正後は同じ方式、接続先の選択、ヘッダー、時間上限で比較します。HTTP状態、本文の意味、要求の成功を確認し、verboseの表示が短くなったことだけを改善と呼ばず、利用者が必要な応答へ到達したかを判断します。