docker runまたはdocker compose up実行時に「Bind for 0.0.0.0:3000 failed: port is already allocated」というエラーが発生しました。原因と対処法は？

解説

正解は「ホスト側のポート3000が既に別のプロセスで使用されている」です。Dockerコンテナのポートマッピング（-p 3000:3000）で指定したホスト側ポートが、別のコンテナやホスト上のプロセスに占有されている場合にこのエラーが発生します。対処法としては、lsof -i :3000（macOS/Linux）やnetstat -ano | findstr :3000（Windows）で使用中のプロセスを特定して停止するか、docker compose downで停止し忘れたコンテナを確認します。あるいはポートマッピングを-p 3001:3000のように別のホストポートに変更する方法もあります。