はじめに

WEBエンジニア転職を目指している初学者です！
Docker環境、Railsで開発している中、

docker compose upのコマンドを叩いたら

Gracefully stopping... (press Ctrl+C again to force)

dependency failed to start: container xxxxxxx is unhealthy

のようなエラーが起きて焦ったため、理由と対処法をまとめます！

エラーの意味

Gracefully stopping... (press Ctrl+C again to force)

dependency failed to start: container xxxxxxx is unhealthy

これは、DBコンテナの「ヘルスチェック（Healthcheck）」が失敗し、依存しているRailsコンテナが起動できなくなった状態です。

PostgreSQL 18以降では、データの保存先ルールが変わったため、古いデータが入っているディレクトリを見つけると「このままだと壊れる可能性があるから起動しないよ」と安全装置が働いています。

PstgreSQL 17以前は

    volumes:
      - postgresql_data:/var/lib/postgresql/data

でしたが、
PstgreSQL 18では

    volumes:
      - postgresql_data:/var/lib/postgresql

と記述します。

マウント先（ymlの書き方）を変えるだけでは、古い中途半端なディレクトリがコンテナ内に残っていて、同じエラーが続くことがあるため、一度ボリュームをリセットして立ち上げ直す必要があります。 (※開発環境のDBデータは消えるので注意してください！)

docker compose down -v
docker compose up

　
仕様変更といえばそれまでですが、
例えるなら、今までの「ピンポイント指定（17）」から「お任せ（18）」に変わった、というイメージですね。

エラーが出た時はびっくりしましたが、postgresql_data:/var/lib/postgresqlで自動で上手いことやってくれるので楽ちんですね！