はじめに

Rails + Docker 環境で開発していると、次のようなエラーに出会うことがあります。

$ docker compose exec web bin/rails generate xxxxx
service "web" is not running

「え、さっきまで動いていたはずでは？」
Docker・Rails を勉強し始めた頃は、どこを見ればいいのか分からず詰まりがちですよね。

この記事では、

なぜこのエラーが出たのか
どこを見て原因を特定したのか
同じ状況になったときの考え方

を、Rails（Docker）前提で整理します。

結論から言うと

docker compose exec web は、web コンテナが起動していないと実行できません。
今回は「ポート競合」が原因で、web コンテナが起動に失敗していました。

本当にwebコンテナが起動しているか？

まずは思い込みを捨てて事実確認。
docker compose ps で確認

$ docker compose ps
NAME                                                      IMAGE                                  COMMAND                   SERVICE   CREATED          STATUS          PORTS
フォルダ名-chrome-1   seleniarm/standalone-chromium:latest   "/opt/bin/entry_poin…"   chrome    12 seconds ago   Up 10 seconds   0.0.0.0:4444->4444/tcp, [::]:4444->4444/tcp
フォルダ名-db-1       mysql:5.7                              "docker-entrypoint.s…"   db        12 seconds ago   Up 10 seconds   0.0.0.0:3307->3306/tcp, [::]:3307->3306/tcp

この時点で分かること：

chrome / db は起動している
web が存在しない（＝起動していない）

web が起動しない理由を調べる

docker compose upして、起動ログを見てみます。

$ docker compose up
[+] Running 4/4
 ✔ Network フォルダ名_default     Created                                                                                                                                                             0.0s 
 ✔ Container フォルダ名-db-1      Created                                                                                                                                                             0.1s 
 ✔ Container フォルダ名-chrome-1  Created                                                                                                                                                             0.1s 
 ✔ Container フォルダ名-web-1     Created                                                                                                                                                             0.3s 
Attaching to chrome-1, db-1, web-1
db-1  | 2026-01-24 14:30:14+09:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 5.7.44-1.el7 started.
chrome-1  | 2026-01-24 05:30:15,032 INFO Included extra file "/etc/supervisor/conf.d/selenium.conf" during parsing
chrome-1  | 2026-01-24 05:30:15,038 INFO RPC interface 'supervisor' initialized
chrome-1  | 2026-01-24 05:30:15,038 CRIT Server 'unix_http_server' running without any HTTP authentication checking
chrome-1  | 2026-01-24 05:30:15,059 INFO supervisord started with pid 8
Gracefully Stopping... press Ctrl+C again to force
Error response from daemon: failed to set up container networking: driver failed programming external connectivity on endpoint フォルダ名-web-1 (17cd568c21f6c0c93c7256dfe2d33a4ea429d12765e4b31d0064300af1092d0d): Bind for 0.0.0.0:3000 failed: port is already allocated

勉強し始めのときは、何が書いてあるのか、どこを読めばいいのかわからないですよね。

ここで注目するのが、Errorと書いてある一番下の行。

Error response from daemon: failed to set up container networking: driver failed programming external connectivity on endpoint フォルダ名-web-1 (17cd568c21f6c0c93c7256dfe2d33a4ea429d12765e4b31d0064300af1092d0d): Bind for 0.0.0.0:3000 failed: port is already allocated

翻訳すると：
エラー: コンテナのネットワーク設定に失敗しました。エンドポイントフォルダ名-web-1 (17cd568c21f6c0c93c7256dfe2d33a4ea429d12765e4b31d0064300af1092d0d) の外部接続のバインド設定に失敗しました: 0.0.0.0:3000 へのバインドが失敗しました。ポートは既に割り当てられています。

＝＞ポート3000を使おうとしたが、すでに他で使われている

原因の切り分け

ポートはすでに割り当てられている

＝別のDocker Composeプロジェクトでwebが起動している
＝他のアプリが 3000 番を占有している

今回は、
別のフォルダでDockerを立ち上げっぱなしだった

というしょうもないことが原因でした。

対処法

別フォルダ側でコンテナを停止：
docker compose down

その後、作業中のフォルダで改めて：
docker compose up

→ web コンテナが正常に起動
→ docker compose exec web ... も実行できるようになりました。

まとめ

今回のポイントは次の3つです。

docker compose execが失敗したら、まずdocker compose psで起動確認
web がいなければ、docker compose upしてログを見る
エラーの最後の方に原因を語っていないか確認

プログラミング学習初期は、

エラー文が長くて読む気がしない
AIに言われたコマンドをそのまま叩くだけ
「なぜ直ったのか」が分からないまま進む

という状態になりがちだと思います。

自分もまさにそうでした。

ですが今回のように、「どこを見て」「どう考えて」「原因を切り分けたか」

を一度経験すると、次からは自力で辿れるようになります。

同じところで詰まっている方の参考になれば幸いです。