Docker for Windowsの「WSL Integration」エラーとその対処法

今回は、Docker for Windows を使用中に発生した「WSL Integration」関連のエラーと、その対処方法について共有したいと思います。

発生したエラー

先日、Docker コンテナを起動しようとしたところ、以下のエラーが表示され、再起動しても解消されませんでした。

WSL integration with distro 'Ubuntu' unexpectedly stopped. Do you want to restart it?
configuring docker in Ubuntu: docker cli config: failed to write file: exit status 2

前日までは問題なく動作していたため、WSL（Windows Subsystem for Linux）側が不安定になっているのではないかと考え、次のコマンドで WSL を一度シャットダウンしました。

wsl --shutdown

再び Docker Desktop を起動すると、今度は以下の別のエラーが発生しました。

WSL integration with distro 'Ubuntu' unexpectedly stopped. Do you want to restart it?
retrieving homedir for Ubuntu distro: getting home folder for Ubuntu distro: running echo $HOME in Ubuntu: sending to distro: write |1: The pipe is being closed.

再起動を試みてもコンテナの起動には至らず、Ubuntu 側の WSL 環境が壊れている可能性が考えられました。

WSL（Ubuntu）に直接ログインできるか確認

念のため、WSL 上の Ubuntu に直接ログインできるか確認してみました。

wsl -d Ubuntu

すると以下のように、正常にログインできました：

Welcome to Ubuntu 22.04.2 LTS (GNU/Linux 4.4.0-19041-Microsoft x86_64)
…
linux@LAPTOP:/mnt/c/Users/nishida$

このことから、WSL 自体は正常に動作しており、Docker Desktop 側の連携に問題があると判断しました。

一時的な回避策：WSL Integration をオフにする

以下の手順で、WSL との連携を一時的に無効化してみました。

１. Docker Desktop を開く

２. Settings > Resources > WSL Integration に移動

３. 「Enable integration with my default WSL distro」のチェックを外す

４. Docker Desktop を再起動

この状態では WSL 経由での連携はできませんが、Docker コンテナの起動自体は可能で、開発作業も継続できることが確認できました。

・Windows 側（cmd、PowerShell、VSCode など）から docker CLI の利用は可能

・Vue.js プロジェクトのビルドも問題なし

→ただし、WSL（Ubuntu）内では docker コマンドが使用できません。

恒久的な対処：WSL バージョンを 2 にアップグレード

より根本的な解決策として、Ubuntu を WSL 1 → WSL 2 にアップグレードすることにしました。これは再インストール不要で、次のコマンドでアップグレード可能です：

wsl –set-version Ubuntu 2

変換後に再び Docker Desktop の設定画面へ行き、

Settings > Resources > WSL Integration にて
「Enable integration with my default WSL distro」にチェックを入れ直して保存。

この後は、エラーも表示されず、WSL との連携も正常に復旧しました。

同じようなエラーに遭遇した方の参考になれば幸いです。

参考リンク：
WSL 2 へのアップグレード方法（Microsoft）
https://learn.microsoft.com/ja-jp/windows/wsl/install

木曜日担当：nishida