WSL2_HYPERV_INACTIVE

WSL2_HYPERV_INACTIVE to błąd wskazujący na wyłączoną platformę Hyper-V lub Virtual Machine Platform wymaganą przez WSL2.

WSL2_HYPERV_INACTIVE — co oznacza ten komunikat

WSL2_HYPERV_INACTIVE oznacza, że środowisko Windows Subsystem for Linux 2 nie może uruchomić wymaganej warstwy wirtualizacji sprzętowej. WSL2 korzysta z lekkiej maszyny wirtualnej opartej na mechanizmach platformy Hyper-V. Do jej działania potrzebna jest przede wszystkim funkcja systemu Windows o nazwie Virtual Machine Platform, a także aktywny składnik Windows Subsystem for Linux. Wyłączenie jednego z tych elementów może uniemożliwić uruchomienie dystrybucji Linuksa.

Nazwa błędu może sugerować, że zawsze trzeba instalować pełną rolę Hyper-V. Nie jest to ścisłe. WSL2 może działać na edycjach systemu, w których pełna rola Hyper-V nie jest dostępna, jeśli aktywna jest funkcja Virtual Machine Platform oraz sprzętowa obsługa wirtualizacji. Istotne jest również, aby hypervisor systemu Windows był uruchamiany podczas startu komputera. Jeżeli hypervisor został wyłączony w konfiguracji rozruchowej, sama instalacja WSL2 nie wystarczy.

Różnica między Hyper-V, Virtual Machine Platform i WSL2

WSL2 nie jest klasyczną maszyną wirtualną uruchamianą w osobnym programie z pełnym interfejsem zarządzania. System tworzy lekkie środowisko wirtualne, w którym działa rzeczywiste jądro Linuksa. Za izolację i dostęp do zasobów procesora odpowiada warstwa wirtualizacyjna Windows. Z tego powodu WSL2 zależy od funkcji Virtual Machine Platform, nawet jeśli użytkownik nie korzysta bezpośrednio z konsoli Hyper-V Manager.

Pełna funkcja Hyper-V, Virtual Machine Platform oraz Windows Subsystem for Linux są odrębnymi składnikami systemu Windows. Włączenie jednego z nich nie zawsze automatycznie aktywuje pozostałe. W praktyce należy sprawdzić, czy system ma aktywną funkcję Virtual Machine Platform, czy składnik WSL jest dostępny oraz czy procesor udostępnia rozszerzenia wirtualizacji. W komputerach z procesorem Intel może to być Intel VT-x, a w komputerach z procesorem AMD — AMD-V. Opcja ta jest ustawiana w oprogramowaniu układowym UEFI lub BIOS, zwykle pod nazwą odnoszącą się do CPU Virtualization, SVM albo Intel Virtualization Technology.

Sprawdzanie funkcji systemu i ustawień rozruchowych

Pierwszym krokiem jest sprawdzenie stanu WSL za pomocą polecenia wsl --status. Można również użyć wsl --version, aby zobaczyć informacje o zainstalowanym składniku WSL, o ile dana wersja systemu obsługuje to polecenie. Stan funkcji opcjonalnych Windows można zweryfikować w oknie „Włącz lub wyłącz funkcje systemu Windows” albo z poziomu PowerShella uruchomionego z uprawnieniami administratora. Wymagane są funkcje VirtualMachinePlatform oraz Microsoft-Windows-Subsystem-Linux.

Do ich aktywacji służą między innymi polecenia dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart oraz dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart. Po zmianie funkcji systemowych zwykle potrzebne jest ponowne uruchomienie komputera. Jeżeli problem nadal występuje, należy sprawdzić konfigurację hypervisora poleceniem bcdedit /enum. Wartość hypervisorlaunchtype ustawiona na off uniemożliwia uruchomienie hypervisora podczas startu systemu; ustawienie auto pozwala Windows uruchamiać go automatycznie. Zmiana konfiguracji rozruchowej wymaga uprawnień administratora i powinna być wykonywana ostrożnie, ponieważ dotyczy mechanizmu startu systemu.

Naprawa WSL2_HYPERV_INACTIVE w laptopie lub komputerze PC

Diagnostykę warto rozpocząć od ustalenia, czy problem dotyczy samego WSL, czy całej obsługi wirtualizacji. W Menedżerze zadań, w zakładce „Wydajność” i sekcji „Procesor”, system Windows pokazuje stan pozycji „Wirtualizacja”. Jeżeli widnieje jako wyłączona, należy aktywować odpowiednią opcję w UEFI lub BIOS. Po tej zmianie system trzeba uruchomić ponownie, ponieważ ustawienie procesora jest odczytywane na etapie startu komputera.

Następnie należy sprawdzić aktualizacje systemu Windows oraz pakietu WSL. Polecenie wsl --update służy do aktualizacji składnika WSL, natomiast wsl --shutdown zatrzymuje działające instancje WSL przed ponowną próbą uruchomienia. Domyślną wersję nowych dystrybucji można ustawić poleceniem wsl --set-default-version 2, ale samo ustawienie wersji nie włączy brakujących funkcji systemowych ani wirtualizacji sprzętowej. Jeżeli błąd pojawia się po zmianie ustawień BIOS, aktualizacji Windows lub instalacji oprogramowania korzystającego z hypervisora, trzeba ponownie zweryfikować wszystkie trzy warstwy: firmware komputera, funkcje opcjonalne Windows i konfigurację rozruchową.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC oraz ich podzespołów, w tym diagnostyką problemów z uruchamianiem systemu Windows i działaniem popularnego oprogramowania. W przypadku WSL2 analiza może obejmować sprawdzenie konfiguracji systemu, ustawień UEFI lub BIOS, aktywności wymaganych funkcji Windows oraz poprawności instalacji środowiska, bez zakładania z góry, że przyczyną jest uszkodzenie sprzętu.