Docker の 409 とは何か？（公式の定義）

409 は、HTTP標準仕様（RFC 9110）で定められているステータスコードの一つです。

Docker の文脈では、このコードは次のことを意味します。

リクエストの内容がサーバーの現在の状態と矛盾している。

このエラーが出たときは、次の「原因」の節を確認してください。 多くの場合、設定の見直しや手順の確認だけで解決できます。

このエラーが発生する主な原因

Docker で 409 が出るときに、最もよく見られる原因を挙げます。

  • 同じ名前のコンテナーがすでに動いているか停止状態で残っている
  • 同じポートを複数のコンテナーが使おうとしている

具体的な解決手順

上の原因ごとの対処法を、実行できる手順の形でまとめました。 上から順番に試すことで、多くの場合は解決に近づけます。

  1. docker ps -a で同名コンテナーを確認し docker rm コンテナー名 で削除する
  2. docker run 時に --name を変更するか既存コンテナーを先に削除する
  3. -p オプションで別のポート番号を指定する

免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。