docker『Connection Refused』の原因と対処法

# ホスト側で「どのポートが何のコンテナに繋がっているか」を確認
docker ps --format 'table {{.Names}}\t{{.Ports}}'

# Linux/macOSでポートのLISTEN状況を確認
ss -ltnp | grep 8080 || lsof -iTCP:8080 -sTCP:LISTEN

# コンテナ内でアプリがどこでLISTENしているかを確認
docker exec -it <container> sh -lc "netstat -ltnp || ss -ltnp"

# 例: Express(Node.js) の場合
app.listen(8080, '0.0.0.0', () => {
  console.log('listening on 0.0.0.0:8080');
});

# NG例: アプリはコンテナ内で8080待ち受けなのに、80をマップしている
docker run -p 80:80 myapp

# OK例: コンテナ内ポートに合わせてマッピング
docker run -p 8080:8080 myapp

# docker-compose.yml の例
services:
  web:
    image: myapp
    ports:
      - "8080:8080"  # host:container

# docker-compose.yml の例
services:
  app:
    image: myorg/app
    depends_on:
      - db
  db:
    image: postgres:16
    environment:
      - POSTGRES_USER=app
      - POSTGRES_PASSWORD=secret

# appコンテナ内からDBに繋ぐ例
psql -h db -U app -d appdb

# よくあるNG例: localhost:5432 に繋ごうとしてしまう（自コンテナの中を見にいく）
DATABASE_URL=postgres://app:secret@localhost:5432/appdb  # ← コンテナ間ではNG

# コンテナ内から接続テスト
docker exec -it <container> sh -lc "
  nc -vz db.example.com 5432 || echo 'ng'
"

# DNS名が間違っていないかも確認
docker exec -it <container> sh -lc "ping -c1 db.example.com || nslookup db.example.com"

# ログでアプリの起動状況を見る
docker logs <container> --tail=200

# 再起動を繰り返している場合（Exit Codeが非0）
docker ps -a --filter "name=<service>" --format 'table {{.Names}}\t{{.Status}}\t{{.ExitCode}}'

services:
  db:
    image: postgres:16
    healthcheck:
      test: ["CMD-SHELL","pg_isready -U postgres"]
      interval: 5s
      timeout: 3s
      retries: 10
  app:
    image: myorg/app
    depends_on:
      db:
        condition: service_health

# WSL2内からホストWindows側にアクセスする場合のIP例
ipconfig.exe | grep "vEthernet (WSL)" -n -A5

# ホスト側から
curl -v http://localhost:8080/health || echo "ng"
nc -vz localhost 8080

# コンテナ側から
docker exec -it <container> sh -lc "
  echo '--- from container ---'
  nc -vz web 8080 || nc -vz localhost 8080
"

# 1) アプリが127.0.0.1でLISTENしている
# NG:
app.listen(8080, '127.0.0.1');
# OK:
app.listen(8080, '0.0.0.0');

# 2) ポートマッピングミス
# NG: コンテナ内ポートと違う
docker run -p 8080:80 myapp
# OK: 正しいポートをマップ
docker run -p 8080:8080 myapp

# 3) コンテナ間接続でlocalhostを使う
# NG:
DATABASE_HOST=localhost
# OK:
DATABASE_HOST=db        # サービス名

# 4) DB起動前にappが繋ぎに行く
# NG: depends_onだけ
depends_on:
  - db
# OK: healthcheck + condition
depends_on:
  db:
    condition: service_healthy

1) どこからどこへ繋ぎにいっているか（ホスト→コンテナ／コンテナ→コンテナ／コンテナ→外部）を明確にしたか
2) 接続先IP/ホスト名とポートが正しいか、portsのhost:container対応と合っているか
3) コンテナ内のアプリが0.0.0.0:ポートでLISTENしているか（127.0.0.1ではないか）
4) コンテナ間接続でlocalhostを使っていないか（サービス名を使っているか）
5) アプリは起動に成功し、そのポートで待ち受けているか（ログと状態を確認したか）
6) 外部サービスに対して、Firewall/セキュリティグループ/プロキシが邪魔していないか
7) Docker Desktop/WSL2の場合、階層（ホスト/VM/WSL）を理解して疎通確認したか
8) curl/ncで、どのレイヤからも接続テストを行い、通る/通らない組み合わせを確認したか