Docker Desktopでコンテナが応答しない・停止できないときの調査と対処【Windows 11・WSL2】

このサイトはアフィリエイト広告(Amazonアソシエイト含む)を掲載しています。
Dockerのコンテナが応答せず停止できない状態と、WSL2のメモリ上限が1GBに設定されている様子を示したイラスト

Windows 11のDocker DesktopでWordPressの開発環境を動かしていたところ、起動してしばらくは正常に動作するものの、いつの間にかアクセスできなくなる現象が発生しました。

さらにDocker Desktopからコンテナを停止しようとしても失敗し、最終的にはWindowsを再起動しないと復旧できない状態でした。

原因を調査したところ、WSL2に割り当てられたメモリの上限が1GBしかないことが判明しました。

今回は実際に発生した症状、実行した調査コマンド、WSL2のメモリ上限を4GBに変更してDockerが正常に応答するようになるまでの流れを紹介します。

検証環境(確認日:2026年11月)
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 Error

Docker Desktop上では各コンテナが起動しているように表示されていましたが、実際にはWordPressもphpMyAdminも利用できません。Docker Desktopの再起動では復旧できず、Windowsの再起動が必要な状態でした。

Dockerコンテナの状態を確認する

まずPowerShellからコンテナの状態を確認しました。

PowerShell
docker ps -a
実行結果
NAME             STATUS
wp               Up 25 hours
wp-phpmyadmin    Up 25 hours
wp-mariadb       Up 25 hours

WordPress・MariaDB・phpMyAdminの3コンテナがいずれもUp 25 hoursと表示されていました。Dockerはコンテナを起動中と認識していますが、実際にはサービスが応答しない状態です。

続いてコンテナのCPU使用率やメモリ使用量を確認しました。

PowerShell
docker stats --no-stream

しかし、このコマンドは応答が返ってきませんでした。

docker ps -aは実行できる一方docker stats --no-streamは応答しないため、単純にWordPressだけが停止している状況ではなさそうです。DockerエンジンやWSL2側も含めて調査することにしました。

docker infoでメモリ容量を確認する

続いてDockerエンジンの情報を取得しました。これは結果が返ってきました。

PowerShell
docker info
実行結果
Server:
 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で以下を実行します。

PowerShell
Get-CimInstance Win32_ComputerSystem |
    Select-Object TotalPhysicalMemory
実行結果
TotalPhysicalMemory
-------------------
        33396535296

物理メモリは約32GB搭載しています。Windows側の物理メモリ容量が極端に少ないわけではありません。

.wslconfigの設定を確認

次にWSL2の設定ファイルを確認します。

PowerShell
Get-Content "$env:USERPROFILE\.wslconfig"
実行結果
[wsl2]
memory=1GB

WSL2のメモリ上限が1GBに制限されていました。

.wslconfigは自分で作成していなければ存在しない場合があります。ファイルが見つからなければ今回のようにこのファイルで上限を1GBへ制限している状態には当てはまりません。まずはdocker infoのTotal MemoryでDockerが認識している容量を確認してください。memoryにはWSL2の仮想マシンが利用できるメモリの上限を指定できます。

今回の環境ではWSL2が利用できるメモリは最大1GBになっていました。

あっ。そーいえば過去に他でメモリを大量に使うことがありこんな制限を自分でかけたような・・・

WSL2の起動状態を確認

念のため以下のコマンドも実行しました。

PowerShell
wsl --list --verbose
実行結果
NAME              STATE       VERSION
Ubuntu            Stopped     2
docker-desktop     Running     2

docker-desktopがWSL2上で起動していることを確認できました。これらの結果から、WSL2のメモリ制限が今回の不具合に関係している可能性が高いと考え設定を変更することにしました。

WSL2のメモリ上限を1GBから4GBに変更

今回はWSL2のメモリ上限を4GBに変更しました。設定ファイルはWindowsユーザーのホームディレクトリにあります。

C:\Users\<ユーザー名>\.wslconfig

今回は[wsl2]内のmemory=1GBをmemory=4GBに変更しました。既存ファイルにほかの設定がある場合は、その設定を残してmemoryの値だけを変更します。

[wsl2]
memory=1GB

→

↓

[wsl2]
memory=4GB

memory=4GBは常に4GBのメモリを消費するという意味ではなく、WSL2が利用できるメモリの上限を指定する設定です。

WSL2を再起動する

WSL2を再起動させる・・・なのですが、フリーズしてしまっているのかシャットダウンできませんでした。なので今回はWindows自体を再起動しました。

設定変更後の動作を確認

Docker Desktopを再起動したあと、メモリ上限が正しく反映されているか確認しました。

Dockerの認識メモリを確認

以下のPowerShellコマンドを実行しました。

PowerShell
[math]::Round(
    [double](docker info --format '{{.MemTotal}}') / 1GB, 2
)
実行結果
3.82

変更前の894.2MiBから約3.82GiBに増えました。設定した4GBに近い容量がDockerから認識されています。

docker statsが正常に応答するようになった

以前は応答しなかったコマンドを再実行しました。今度は正常に結果が返ってきました。

PowerShell
docker stats --no-stream
実行結果
CONTAINER 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
.wslconfigmemory=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を見直し、変更前後の応答時間を測った結果を別記事にまとめています。

  • URLをコピーしました!
目次