ステータス・終了コード検索
HTTP ステータスコード、Docker と Kubernetes の終了コード、ネットワーク errno を一か所で検索します。各項目に原因、すぐ実行できる確認コマンド、再試行の可否が並びます。
ブラウザ内だけで動作します。入力した内容はどこにもアップロードされません。
- 200OK再試行可HTTP
リクエストは成功し、本文に結果が入っています。200 なのに本文が空なら、キャッシュや例外処理の分岐から返していることがよくあります。
curl -i https://example.com/api/healthcurl -sS https://example.com/api/health | head -c 200- 同じリクエストをそのまま送り直してかまいません。
- 201Created再試行しないHTTP
リクエストでリソースが作成されました。Location ヘッダーが新しいレコードを指し、これがないとクライアントは次のリクエストを続けにくくなります。
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/items- 同じリクエストを繰り返しても同じ応答が返るだけです。
- 204No Content再試行しないHTTP
リクエストは成功し、応答本文はありません。常に JSON を解析するコードはここで unexpected end of JSON input エラーになります。
curl -i -X DELETE https://example.com/api/items/42- 同じリクエストを繰り返しても同じ応答が返るだけです。
- 301Moved Permanently再試行可HTTP
URL が恒久的に変わり、クライアントはリダイレクトをキャッシュします。古いパスが戻らない場合だけ使い、一時的な移動には 302 か 307 を使います。
curl -sSIL https://example.com/old-path- 同じリクエストをそのまま送り直してかまいません。
- 302Found再試行可HTTP
一時的なリダイレクトですが、クライアントが POST を GET に変えることがあります。メソッドを保つ必要がある API なら 307 か 308 を使ってください。
curl -sSIL https://example.com/login- 同じリクエストをそのまま送り直してかまいません。
- 304Not Modified再試行可HTTP
キャッシュがまだ有効なので本文を送っていません。If-None-Match や If-Modified-Since があるときだけ現れ、ログではエラーではありません。
curl -i -H 'If-None-Match: "etag"' https://example.com/page- 同じリクエストをそのまま送り直してかまいません。
- 307Temporary Redirect再試行可HTTP
メソッドと本文を保つ一時的なリダイレクトです。POST を別の URL に送り直す必要がある場合に適しています。
curl -sSIL -X POST https://example.com/api/old- 同じリクエストをそのまま送り直してかまいません。
- 308Permanent Redirect再試行可HTTP
メソッドと本文を保つ恒久的なリダイレクトです。ブラウザーがキャッシュするため、宛先を間違えると戻すのが難しくなります。
curl -sSIL https://example.com/old- 同じリクエストをそのまま送り直してかまいません。
- 400Bad Request修正後に再試行HTTP
サーバーがリクエストを読めませんでした。壊れた JSON、必須フィールドの欠落、誤った Content-Type が典型で、多くのフレームワークは応答本文に問題のフィールドを示します。
curl -i -X POST -H 'Content-Type: application/json' -d '{"name":"test"}' https://example.com/api/itemsecho '{"name":"test"}' | python3 -m json.tool- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 401Unauthorized修正後に再試行HTTP
認証情報がないか無効です。Authorization ヘッダーの欠落、期限切れのトークン、誤ったスキームが原因で、WWW-Authenticate ヘッダーでサーバーの要求を確認できます。
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/mecurl -sSI https://example.com/api/me | grep -i www-authenticate- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 403Forbidden修正後に再試行HTTP
認証は通っていますが権限がありません。ロールやスコープ、バケットやテーブルのポリシー、IP 許可リストを確認してください。ログイン後の 403 はトークンではなく権限の問題です。
curl -i -H "Authorization: Bearer $TOKEN" https://example.com/api/admin- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 404Not Found再試行しないHTTP
パスまたはレコードが存在しません。ルート、末尾のスラッシュ、base URL、id を確認してください。プロキシがパスの接頭辞を落としても同じ応答になります。
curl -sSIL https://example.com/api/items/42curl -sS http://localhost:3000/api- 同じリクエストを繰り返しても同じ応答が返るだけです。
- 405Method Not Allowed修正後に再試行HTTP
ルートはありますが、このメソッドは受け付けません。POST 専用のエンドポイントへの GET や、プロキシやフォームによるメソッドの書き換えが原因で、Allow ヘッダーに許可されるメソッドが出ます。
curl -i -X GET https://example.com/api/items- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 408Request Timeout再試行可HTTP
クライアントが制限時間内にリクエストを送りきれませんでした。低速な回線でのアップロードや、クライアントより短いプロキシのタイムアウトが原因です。
curl -sS -o /dev/null -w '%{time_total}s\n' https://example.com/api/upload- 同じリクエストをそのまま送り直してかまいません。
- 409Conflict修正後に再試行HTTP
現在の状態と衝突しています。重複する一意キー、同じ行への同時更新、楽観ロックのバージョン不一致が原因で、読み直してから再試行する価値があります。
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"a@b.c"}' https://example.com/api/users- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 413Payload Too Large修正後に再試行HTTP
本文がサーバーまたは手前の上限を超えています。nginx の client_max_body_size、サーバーレスのリクエスト上限、フレームワークの本文上限を確認し、圧縮するか分割して送ってください。
du -h ./upload.zipcurl -i -F 'file=@upload.zip' https://example.com/api/upload- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 415Unsupported Media Type修正後に再試行HTTP
エンドポイントが受け付けない Content-Type です。JSON の本文をフォームデータとして送った場合が多く、application/json に合わせて本文も有効な JSON にしてください。
curl -i -X POST -H 'Content-Type: application/json' -d '{"a":1}' https://example.com/api/items- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 422Unprocessable Entity修正後に再試行HTTP
形式は正しいものの値が検証を通りませんでした。FastAPI、Rails、Laravel などは本文にフィールドのエラーを返すので、リクエストの形を変える前に読んでください。
curl -i -X POST -H 'Content-Type: application/json' -d '{"email":"nope"}' https://example.com/api/users- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 429Too Many Requests再試行可HTTP
レート制限または割り当てに達しました。Retry-After を読み、ジッターを付けて待ち、IP・API キー・ログインユーザーのどれが制限されたかを確認してください。
curl -sSI https://example.com/api/items | grep -i retry-aftersleep 5 && curl -i https://example.com/api/items- 同じリクエストをそのまま送り直してかまいません。
- 500Internal Server Error再試行可HTTP
サーバーが処理できないエラーが発生しました。スタックトレースはサーバーログにあり、特定のルートだけで出る 500 はネットワークではなくそのハンドラーの問題です。
curl -i https://example.com/api/itemsdocker compose logs -f --tail 50 api- 同じリクエストをそのまま送り直してかまいません。
- 502Bad Gateway再試行可HTTP
プロキシは上流に届きましたが使える応答を得られませんでした。アプリが落ちた、再起動中、別のポートで待ち受けている、TLS ポートに HTTP を送った場合です。
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' https://example.com/docker compose ps- 同じリクエストをそのまま送り直してかまいません。
- 503Service Unavailable再試行可HTTP
サーバーは動いていますが応答できません。過負荷、メンテナンスモード、依存サービスの障害、ロードバランサーの後ろに正常なインスタンスがない状態で、Retry-After が再試行の時刻を示します。
curl -sSI https://example.com/ | grep -i retry-afterdocker compose ps- 同じリクエストをそのまま送り直してかまいません。
- 504Gateway Timeout再試行可HTTP
プロキシが上流を待ってタイムアウトを超えました。コードより前に、遅いクエリ、欠けたインデックス、proxy_read_timeout やサーバーレスの実行時間上限を確認してください。
curl -sS -o /dev/null -w '%{http_code} %{time_total}s\n' http://localhost:3000/api/slowpsql "$DATABASE_URL" -c 'EXPLAIN ANALYZE SELECT 1'- 同じリクエストをそのまま送り直してかまいません。
- 0Exit 0 — success再試行可コンテナと終了コード
プロセスが正常に終了しました。一度きりのジョブでは正しく、動き続けるべきサービスでは誤った終了です。エントリーポイントが処理を終えて終了していないか確認してください。
docker logs --tail 50 <container>docker inspect --format '{{.State.ExitCode}}' <container>- 同じリクエストをそのまま送り直してかまいません。
- 1Exit 1 — application error修正後に再試行コンテナと終了コード
アプリケーション自体が失敗しました。捕捉されない例外、失敗した検証、適用されていないマイグレーションが原因で、コンテナログの最後の行に理由があります。
docker logs --tail 100 <container>docker inspect --format '{{.State.ExitCode}}' <container>- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 2Exit 2 — usage error修正後に再試行コンテナと終了コード
シェルの組み込みコマンドかコマンドラインが誤っています。誤ったフラグ、欠けた引数、エントリーポイントのスクリプトが読めないファイルが原因です。
docker logs --tail 50 <container>docker run --rm -it --entrypoint sh <image>- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 126Exit 126 — cannot execute修正後に再試行コンテナと終了コード
コマンドはありますが実行できません。実行権限の欠落、shebang の Windows 改行、イメージにないインタープリターが原因です。
docker run --rm -it --entrypoint sh <image> -c 'ls -l /entrypoint.sh'file /path/to/entrypoint.sh- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 127Exit 127 — command not found修正後に再試行コンテナと終了コード
イメージの PATH にコマンドが見つかりません。誤字、入っていないパッケージ、マルチステージビルドの別ステージにだけあるバイナリが原因です。
docker run --rm -it --entrypoint sh <image> -c 'command -v node'docker run --rm -it --entrypoint sh <image> -c 'echo $PATH'- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 130Exit 130 — SIGINT再試行可コンテナと終了コード
Ctrl-C で停止した場合で、128 にシグナル 2 を足した値です。自分で止めたコンテナでは正常で、誰も触っていないのに出るなら確認が必要です。
docker inspect --format '{{.State.ExitCode}}' <container>- 同じリクエストをそのまま送り直してかまいません。
- 137Exit 137 — SIGKILL / OOMKilled修正後に再試行コンテナと終了コード
128 にシグナル 9 を足した強制終了です。多くは OOM キラーがコンテナを落としており、上限を上げる前にアプリの最大メモリ使用量と上限を比べてください。
docker inspect --format '{{.State.OOMKilled}}' <container>docker stats --no-stream <container>kubectl describe pod <pod> | grep -i -A2 'Last State'- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 139Exit 139 — SIGSEGV修正後に再試行コンテナと終了コード
セグメンテーション違反で落ちました(128+11)。別の libc 向けにビルドされたネイティブモジュールや、Node や Python の ABI の不一致でよく起こります。
docker logs --tail 100 <container>docker inspect --format '{{.Config.Image}}' <container>- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- 143Exit 143 — SIGTERM再試行可コンテナと終了コード
正常な停止信号である SIGTERM(128+15) を受け取りました。勝手に繰り返すなら、アプリが猶予時間内に終了処理を終えていません。
docker inspect --format '{{.Config.StopTimeout}}' <container>docker logs --tail 50 <container>- 同じリクエストをそのまま送り直してかまいません。
- CrashLoopBackOffKubernetes CrashLoopBackOff修正後に再試行コンテナと終了コード
コンテナが終了し続けるため Kubernetes が再起動し、試行の間隔が伸びていきます。直前の試行の出力に終了の理由があります。
kubectl logs <pod> --previous --tail 100kubectl describe pod <pod> | grep -i -A5 'Last State'- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- ImagePullBackOffKubernetes ImagePullBackOff修正後に再試行コンテナと終了コード
イメージを取得できません。存在しないタグ、imagePullSecrets のないプライベートレジストリ、ノードを制限するレジストリのレート制限が原因です。
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret <secret> -o yaml- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- CreateContainerConfigErrorKubernetes CreateContainerConfigError修正後に再試行コンテナと終了コード
コンテナが参照するものが足りず作成できません。Secret や ConfigMap、そのキーの一つ、またはそれを渡すボリュームがないか確認してください。
kubectl describe pod <pod> | sed -n '/Events/,$p'kubectl get secret,configmap- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- EvictedKubernetes Evicted修正後に再試行コンテナと終了コード
ノードのメモリ・ディスク・プロセス資源が不足して Pod が退避されました。実際の使用量と合わない requests/limits や、空きのないノードがよくある原因です。
kubectl get pod <pod> -o jsonpath='{.status.reason}{"\\n"}{.status.message}{"\\n"}'kubectl describe node <node> | grep -i -A6 'Conditions'- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- ECONNREFUSEDECONNREFUSED再試行可ネットワーク Errno
その host と port で待ち受けているプロセスがないか、127.0.0.1 にしか開いていません。Docker の中では localhost ではなくサービス名を使い、ポートはコンテナのポートを指定します。
nc -vz localhost 3000ss -ltnp | grep 3000docker compose ps- 同じリクエストをそのまま送り直してかまいません。
- ECONNRESETECONNRESET再試行可ネットワーク Errno
リクエストの途中で相手が接続を閉じました。ピアが落ちたかタイムアウトし、プロキシやロードバランサーが待機中の接続を切ったか、TLS ポートに HTTP を送った場合です。
curl -v https://example.com/api/itemscurl -v --http1.1 --keepalive-time 30 https://example.com/- 同じリクエストをそのまま送り直してかまいません。
- ETIMEDOUTETIMEDOUT再試行可ネットワーク Errno
制限時間内に応答がありませんでした。ルーティング、ファイアウォールやセキュリティグループ、誤ったホスト、遅すぎるピアが原因で、コードを直す前にポートを確認してください。
nc -vz -w 5 <host> 443curl -sS -o /dev/null -w '%{time_connect}s %{time_total}s\n' https://example.com/- 同じリクエストをそのまま送り直してかまいません。
- ENOTFOUNDENOTFOUND修正後に再試行ネットワーク Errno
ホスト名が解決できませんでした。誤字、検索ドメインの欠落、DNS のないコンテナ、リゾルバーのレート制限が原因です。
getent hosts api.example.comnslookup api.example.com 1.1.1.1- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- EADDRINUSEEADDRINUSE修正後に再試行ネットワーク Errno
このマシンでポートがすでに使われています。別のプロセスや、終了していない以前のインスタンスが握っています。
lsof -i :3000kill -15 $(lsof -t -i :3000)- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
- EACCESEACCES修正後に再試行ネットワーク Errno
権限が拒否されました。権限なしで 1024 未満のポートを開いたか、プロセスが書き込めないファイルやディレクトリです。コンテナでは root 以外のユーザーと root 所有のボリュームの組み合わせがよくあります。
idls -ld /var/lib/appPORT=8080 node server.js- 原因を直してから再試行してください。今すぐ送り直しても結果は同じです。
ステータスと終了コードの参考
クイックリファレンス- 4xx vs 5xx
- 4xx は直すべきなのがクライアントのリクエスト、5xx はサーバーの失敗です。一つのルートだけで出る 502 や 504 は、多くの場合プロキシの後ろの上流の問題です。
- 128 + signal
- シェルはシグナルで終了したプロセスを 128 にシグナル番号を足して報告します。137 は 128+9(SIGKILL)、143 は 128+15(SIGTERM)、139 は 128+11(SIGSEGV) です。
- OOMKilled
- docker inspect で OOMKilled が true の 137 はメモリ上限に達したという意味です。アプリの最大使用量より低い上限は同じように再起動を繰り返させます。
- CrashLoopBackOff
- コンテナが終了し続けて Kubernetes が再起動している状態です。kubectl logs --previous で失敗した試行を確認してください。
- ECONNREFUSED
- その host と port で待ち受けているプロセスがありません。Docker の中ではホストは localhost ではなくサービス名で、ポートもコンテナのポートです。
- Retry-After
- 429 や 503 がいつ戻ればよいかを示すヘッダーです。短い間隔で繰り返さず、ジッターを付けて待ってください。
よくある質問
ツールの下に回答がありますコンテナが 137 で終了しました。どういう意味ですか?
137 は 128+9 の SIGKILL です。メモリ不足のキラーか docker stop で、docker inspect の OOMKilled で区別できます。
CrashLoopBackOff はどんな状態ですか?
コンテナが終了し続けて Kubernetes が再起動している状態です。kubectl logs --previous で前回の原因を確認してください。
503 は再試行してもよいですか?
ジッターを付けて再試行してください。多くは一時的な上流や容量の問題で、Retry-After が待ち時間を示します。
Linux の関連文法ガイド
Linux のガイドをすべて見るLinux: Too many open files (EMFILE) and ulimit
EMFILE is a per-process descriptor limit, ENFILE is the kernel's. Read the limit from /proc, raise it in the right layer, and find the leak that made it matter.
Linuxsystemd status=203/EXEC and 217/USER: Exec and Permission Failures
203 is a failed execve, 217 is a user systemd could not resolve. Both happen before your program runs, and the check that finds each takes one command.
Linuxsystemd Timers vs Cron: Missing PATH, Overlapping Runs, Time Drift
Cron runs a bare shell with no profile and no locking, and systemd reads the system time zone. The environment, single-instance and schedule fixes for both.
LinuxBash Indexed Arrays, Associative Maps, and Parameter Expansion
Quoting decides whether an array stays a list, and the expansion operators replace most external text tools. Includes set -u, mapfile, namerefs, and the bash 3.2 differences that break scripts on macOS.