WSL2のトラブルシューティング入門｜インストール・起動エラーを自分で解決する方法

この記事のポイント

・WSL2の主なエラーは「仮想化設定」「Windowsの機能」「ディストリの未インストール」の3つ
・PowerShellを管理者権限で実行するとほとんどのエラーは解決できる
・ネットワーク接続できない場合は wsl --shutdown から再起動が基本手順
・ファイル権限エラーは /etc/wsl.conf の設定変更で解消できる

# PowerShellを管理者権限で実行する
# スタートメニューで「PowerShell」を右クリック→「管理者として実行」

# 仮想マシンプラットフォームを有効化
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# WSL機能を有効化
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 実行後は必ず再起動する
Restart-Computer

# PowerShellで仮想化の対応状況を確認
systeminfo | findstr /C:"Hyper-V"

# 出力例（すべて「はい」になっていれば問題なし）
# Hyper-V の要件: VM モニター モード拡張機能: はい
# 仮想化が有効にされています: はい
# 第 2 レベルのアドレス変換: はい
# データ実行防止が使用可能: はい

# 「仮想化が有効にされています: いいえ」の場合はBIOS設定が必要

# WSLカーネルを最新版に更新する
wsl --update

# 更新後、インストールを再試行
wsl --install -d Ubuntu

# 実際の出力例
# Ubuntu is already installed.
# Launching Ubuntu...
# （ここでユーザー名とパスワードの設定画面になれば成功）

# まず登録されているディストリビューションを確認
wsl --list --verbose

# 出力例（インストール済みであれば表示される）
#   NAME      STATE           VERSION
# * Ubuntu    Stopped         2

# 何も表示されない場合はインストールが完了していない
# Ubuntuをインストールする場合
wsl --install -d Ubuntu

# 利用可能なディストリビューション一覧を確認
wsl --list --online

# WSLをシャットダウンして再起動する
wsl --shutdown

# 少し待ってからWSLを起動
wsl

# それでも解決しない場合は、WSL機能を再登録する
# （管理者権限のPowerShellで実行）
Get-AppxPackage -AllUsers -Name "MicrosoftCorporationII.WindowsSubsystemForLinux" | Reset-AppxPackage

# Hyper-Vの状態確認
Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V

# 実際のエラー確認には wsl --status が便利
wsl --status

# 出力例
# 既定のディストリビューション: Ubuntu
# 既定のバージョン: 2
# Linux 用 Windows サブシステムの最終更新日: 2026/06/01

# WSL2内のシェルで実行

# まずpingで接続を確認
ping -c 3 8.8.8.8

# 実際の出力例（接続OKの場合）
# PING 8.8.8.8 (8.8.8.8) 56(84) bytes of data.
# 64 bytes from 8.8.8.8: icmp_seq=1 ttl=113 time=12.4 ms
# 64 bytes from 8.8.8.8: icmp_seq=2 ttl=113 time=11.9 ms

# DNSが引けない場合は /etc/resolv.conf を確認
cat /etc/resolv.conf

# 出力例
# nameserver 172.22.240.1

# /etc/wsl.conf にDNS自動生成を無効にする設定を追加
sudo sh -c 'echo "[network]
generateResolvConf = false" >> /etc/wsl.conf'

# /etc/resolv.conf を手動で設定（GoogleのDNSを使う例）
sudo sh -c 'echo "nameserver 8.8.8.8
nameserver 8.8.4.4" > /etc/resolv.conf'

# WSL2を再起動して設定を反映
# （PowerShellで実行）
# wsl --shutdown

# WSL2内でWindowsホストのIPアドレスを確認する
ip route show | grep -i default

# 出力例（デフォルトゲートウェイがWindowsのIP）
# default via 172.22.240.1 dev eth0 proto kernel

# WindowsホストへのアクセスはそのIPアドレスを使う
# 例: Windows上で動くMySQL（3306番ポート）に接続する場合
# mysql -h 172.22.240.1 -u root -p

# /mnt/c/ のファイル権限確認（デフォルトでは777になる）
ls -la /mnt/c/Users/

# 出力例
# drwxrwxrwx 1 tomohiro tomohiro 4096 Jul  1 08:00 tomohiro

# /etc/wsl.conf でメタデータを有効化すると権限が正確に扱える
sudo nano /etc/wsl.conf

# 以下の内容を追加
# [automount]
# options = "metadata"

# WSL2を再起動して設定を反映
# PowerShellで: wsl --shutdown
# その後 Ubuntu を起動

# ファイルの現在の権限と所有者を確認
ls -la /home/tomohiro/script.sh

# 出力例
# -rw-r--r-- 1 tomohiro tomohiro 125 Jul  1 08:00 script.sh

# スクリプトに実行権限を付与
chmod +x /home/tomohiro/script.sh

# 再確認
ls -la /home/tomohiro/script.sh
# -rwxr-xr-x 1 tomohiro tomohiro 125 Jul  1 08:00 script.sh

# root権限が必要なファイルを操作する場合
sudo chmod 644 /etc/配下のファイル