Tips

Dockerを使用したNuxt3の開発環境構築:エラーの対処法

開発環境を構築し、実装を始めると、予期せぬエラーが度々発生し……解決に時間を取られてしまいました。ここでは、DockerとNuxt3を使用して開発を行う際に遭遇したいくつかのエラーとその対処法を紹介します!

エラー1: ブラウザが再読み込みを繰り返す

  • 症状:http://localhost:3000/にアクセスすると、ブラウザが再読込みを繰り返す。コンソールに「websocket connection to ‘ws://localhost:24678/_nuxt/’ failed」とエラーが出ている。
  • 対処法:docker-compose.ymlにHMR用のポート「24678」を追加する
    version: "3"
    services:
      front:
        build:
          context: ./front
          dockerfile: Dockerfile
        ports:
          - 3000:3000
          - 24678:24678 //追加​
  • 原因:Dockerのポートフォワード設定において、24678ポートが開放されていなかったため、HMR機能が正常に機能せず、接続エラーが発生いたようです。
  • 参考

 

エラー2:Nuxt3のコンテナが起動できない

  • 症状:docker compose upでコンテナ起動しようとした際、「[nitro] [uncaughtException] Error: listen EADDRINUSE: address already in use /tmp/nitro/worker-30-1.sock」と表示され、起動できない
  • 対処法:下記、コマンドを実行し、コンテナを再生成する
    docker compose up --force-recreate​
  • 原因:NITROのワーカーファイルが/tmpディレクトリに残っているのが原因のようです
  • 参考

 

エラー3:ある日突然、、Docker Desktop Windowsが起動しない

  • 症状:デスクトップのDocker Desktop Windowsのアイコンをクリックして起動すると、「Docker failed to initialize」と記述された画面が表示される
  • 対処法:「C:\Users\[ユーザー]\AppData\Roaming\Docker」を削除して、DockerDesktopを再起動する
  • 原因:Docker Desktop Windowsを停止せずに、マシンをシャットダウン、再起動後にエラーに遭遇しました
  • 参考

 

エラー4: Docker Engine stopped

  • 症状:Docker Desktop Windowsを立ち上げると「Docker Engine stopped」というメッセージがでる
エラー画像1
  • 対処法:Docker Desktop Windowsを開き、右上隅にある「troubleshoot」アイコンをクリック。「Clean / Purge data」をクリックし、「WSL 2」のみを選択して「Ddelete」ボタンをクリック。マシンを再起動後、立ち上がりました。
  • 参考
 

 

N.T
平日はコーディング、週末は子供と公園を走り回っています。