Windows 11のDocker DesktopでWordPressの開発環境を動かしていたところ、起動してしばらくは正常に動作するものの、いつの間にかアクセスできなくなる現象が発生しました。
さらにDocker Desktopからコンテナを停止しようとしても失敗し、最終的にはWindowsを再起動しないと復旧できない状態でした。
原因を調査したところ、WSL2に割り当てられたメモリの上限が1GBしかないことが判明しました。
今回は実際に発生した症状、実行した調査コマンド、WSL2のメモリ上限を4GBに変更してDockerが正常に応答するようになるまでの流れを紹介します。
- OS
Windows 11 Home 25H2
- Docker Desktop
4.97.0
- WSL
2.7.14.0
- Docker内コンテナ
- WordPress (wordpress:7.1.3-php8.5-apache)
- MariaDB (mariadb:11.8)
- phpMyAdmin (phpmyadmin)
発生した症状
WSL2バックエンドを使用したDocker Desktop上にWordPressのローカル開発環境を作成していました。
起動直後はWordPressの管理画面やphpMyAdminにアクセスできます。しかし、しばらくするとアクセスできなくなり、Docker Desktopからの停止操作も失敗するようになりました。
停止しようとすると以下のエラーが表示されます。
Cannot stop Docker Compose
application. Reason: Max retries
reached: Headers Timeout ErrorDocker Desktop上では各コンテナが起動しているように表示されていましたが、実際にはWordPressもphpMyAdminも利用できません。Docker Desktopの再起動では復旧できず、Windowsの再起動が必要な状態でした。
Dockerコンテナの状態を確認する
まずPowerShellからコンテナの状態を確認しました。
docker ps -aNAME STATUS
wp Up 25 hours
wp-phpmyadmin Up 25 hours
wp-mariadb Up 25 hoursWordPress・MariaDB・phpMyAdminの3コンテナがいずれもUp 25 hoursと表示されていました。Dockerはコンテナを起動中と認識していますが、実際にはサービスが応答しない状態です。
続いてコンテナのCPU使用率やメモリ使用量を確認しました。
docker stats --no-streamしかし、このコマンドは応答が返ってきませんでした。
docker ps -aは実行できる一方docker stats --no-streamは応答しないため、単純にWordPressだけが停止している状況ではなさそうです。DockerエンジンやWSL2側も含めて調査することにしました。
docker infoでメモリ容量を確認する
続いてDockerエンジンの情報を取得しました。これは結果が返ってきました。
docker infoServer:
Server Version: 29.9.2
Operating System: Docker Desktop
OSType: linux
Architecture: x86_64
CPUs: 16
Total Memory: 894.2MiB気になったのはTotal Memory: 894.2MiBです。Dockerエンジンから認識されている総メモリ容量が1GBにも達していません。この環境ではWordPress・MariaDB・phpMyAdminの3つを動かしているため、メモリ制限が厳しすぎる可能性があります。
WSL2のメモリ設定を調査する
Docker DesktopはWSL2を利用しているため、Windows側のメモリ容量とWSL2の設定を確認しました。
Windowsの物理メモリを確認
PowerShellで以下を実行します。
Get-CimInstance Win32_ComputerSystem |
Select-Object TotalPhysicalMemoryTotalPhysicalMemory
-------------------
33396535296物理メモリは約32GB搭載しています。Windows側の物理メモリ容量が極端に少ないわけではありません。
.wslconfigの設定を確認
次にWSL2の設定ファイルを確認します。
Get-Content "$env:USERPROFILE\.wslconfig"[wsl2]
memory=1GBWSL2のメモリ上限が1GBに制限されていました。
.wslconfigは自分で作成していなければ存在しない場合があります。ファイルが見つからなければ今回のようにこのファイルで上限を1GBへ制限している状態には当てはまりません。まずはdocker infoのTotal MemoryでDockerが認識している容量を確認してください。memoryにはWSL2の仮想マシンが利用できるメモリの上限を指定できます。
今回の環境ではWSL2が利用できるメモリは最大1GBになっていました。
あっ。そーいえば過去に他でメモリを大量に使うことがありこんな制限を自分でかけたような・・・
WSL2の起動状態を確認
念のため以下のコマンドも実行しました。
wsl --list --verboseNAME STATE VERSION
Ubuntu Stopped 2
docker-desktop Running 2docker-desktopがWSL2上で起動していることを確認できました。これらの結果から、WSL2のメモリ制限が今回の不具合に関係している可能性が高いと考え設定を変更することにしました。
WSL2のメモリ上限を1GBから4GBに変更
今回はWSL2のメモリ上限を4GBに変更しました。設定ファイルはWindowsユーザーのホームディレクトリにあります。
C:\Users\<ユーザー名>\.wslconfig今回は[wsl2]内のmemory=1GBをmemory=4GBに変更しました。既存ファイルにほかの設定がある場合は、その設定を残してmemoryの値だけを変更します。
[wsl2]
memory=1GB→
↓
[wsl2]
memory=4GBmemory=4GBは常に4GBのメモリを消費するという意味ではなく、WSL2が利用できるメモリの上限を指定する設定です。
WSL2を再起動する
WSL2を再起動させる・・・なのですが、フリーズしてしまっているのかシャットダウンできませんでした。なので今回はWindows自体を再起動しました。
設定変更後の動作を確認
Docker Desktopを再起動したあと、メモリ上限が正しく反映されているか確認しました。
Dockerの認識メモリを確認
以下のPowerShellコマンドを実行しました。
[math]::Round(
[double](docker info --format '{{.MemTotal}}') / 1GB, 2
)3.82変更前の894.2MiBから約3.82GiBに増えました。設定した4GBに近い容量がDockerから認識されています。
docker statsが正常に応答するようになった
以前は応答しなかったコマンドを再実行しました。今度は正常に結果が返ってきました。
docker stats --no-streamCONTAINER ID NAME CPU % MEM USAGE / LIMIT MEM % NET I/O BLOCK I/O PIDS
5967474a78ab wp 0.00% 25.31MiB / 3.822GiB 0.65% 1.65kB / 126B 122MB / 4.1kB 6
ef556b23de8c wp-phpmyadmin 0.00% 20.34MiB / 3.822GiB 0.52% 1.69kB / 126B 60.3MB / 4.1kB 6
22f13509d1cb wp-mariadb 0.01% 142.7MiB / 3.822GiB 3.65% 1.95kB / 126B 77MB / 28.7kB 9合計のメモリ使用量は約188MiBでした。この時点では3コンテナともメモリ使用量は少なく、Dockerのリソース情報も正常に取得できています。ただ、これはほぼ起動直後の一時点での結果です。
WordPressやMariaDBへのアクセスが増えたときや、長時間稼働したときの最大メモリ使用量を測定したものではありません。
今回の原因として考えられること
今回の調査結果を整理すると、以下のようになります。
| 調査項目 | 結果 |
|---|---|
| コンテナの状態 | 3コンテナともUpと表示 |
| WordPress・phpMyAdmin | 時間経過で応答しなくなる |
| Docker Desktopの停止操作 | Headers Timeout Error |
| docker stats | 応答なし |
| docker info | 実行可能 |
| Dockerが認識したメモリ | 894.2MiB |
| .wslconfig | memory=1GB |
| メモリ上限変更後 | Dockerが3.82GiBを認識 |
| docker stats再実行 | 正常に応答 |
WSL2のメモリ上限が1GBに制限されていたため、メモリ不足が応答停止に関係していた可能性があります。上限を4GBへ変更してWindowsを再起動したところDockerが認識するメモリは約3.82GiBに増えdocker statsも応答するようになりました。
まとめ
- Docker DesktopでWordPressの開発環境を使用していたら、いつの間にかコンテナが応答しなくなって停止操作も失敗する現象が発生したよ。
- WSL2のメモリ上限が1GBに設定されていて、これはちょっと少なすぎる可能性があったよ。
- 今回はWSL2のメモリ上限を4GBに変更すると時間経過しても
docker statsが正常に応答するようになったよ。 - Docker Desktopで複数コンテナを動かしていて、応答停止や停止失敗が発生する場合は
docker infoで認識メモリを確認し.wslconfigの設定も調べてみるといいよ。
WordPressの画面は開くものの表示に時間がかかる場合はファイルの配置も確認してみてください。Windows側からのbind mountを見直し、変更前後の応答時間を測った結果を別記事にまとめています。


