WSL_BOOT_FAILURE

WSL_BOOT_FAILURE to błąd wskazujący na niepowodzenie uruchomienia maszyny wirtualnej podsystemu Windows Subsystem for Linux.

Co oznacza identyfikator WSL_BOOT_FAILURE

WSL_BOOT_FAILURE oznacza niepowodzenie uruchomienia środowiska wykonawczego Windows Subsystem for Linux. W przypadku WSL 2 problem dotyczy przede wszystkim startu lekkiej maszyny wirtualnej, w której działa jądro Linux dostarczane przez WSL. Sam identyfikator nie wskazuje jednej, zawsze takiej samej przyczyny. Jest opisem etapu, na którym system nie zdołał przygotować lub uruchomić instancji WSL. Błąd może pojawić się przed otwarciem powłoki, podczas inicjalizacji dystrybucji albo przy pierwszym uruchomieniu po instalacji.

Nie należy utożsamiać tego komunikatu z błędem konkretnego programu Linux. Jeżeli powłoka dystrybucji nie została jeszcze uruchomiona, przyczyny trzeba szukać w warstwie Windows, konfiguracji WSL, wymaganych składnikach systemu, plikach dystrybucji lub funkcjach sprzętowej wirtualizacji. Inny przebieg może mieć WSL 1, który nie korzysta z tej samej maszyny wirtualnej co WSL 2. Dlatego podczas analizy istotne jest ustalenie, czy problem dotyczy konkretnej dystrybucji, czy całego mechanizmu WSL.

Warstwy systemu uczestniczące w starcie WSL 2

Uruchomienie WSL 2 zależy od kilku współpracujących elementów. W systemie musi być dostępna funkcja „Podsystem Windows dla systemu Linux”, a dla WSL 2 również „Platforma maszyny wirtualnej”. Wymagane są także odpowiednie usługi i składniki systemu Windows oraz procesor z włączoną obsługą wirtualizacji sprzętowej. W zależności od wydania systemu i sposobu instalacji WSL znaczenie może mieć również pakiet aplikacyjny WSL aktualizowany niezależnie od głównego obrazu Windows.

Awaria dowolnej z tych warstw może zatrzymać start przed uruchomieniem dystrybucji. Przykładem jest wyłączona w oprogramowaniu układowym Intel VT-x lub AMD-V, konflikt z innym oprogramowaniem korzystającym z hypervisora, niepełna aktualizacja systemu, uszkodzona rejestracja składnika albo brak zasobów potrzebnych do utworzenia środowiska. WSL 2 korzysta z infrastruktury wirtualizacyjnej Windows, ale komunikat WSL_BOOT_FAILURE nie jest sam w sobie dowodem uszkodzenia procesora ani płyty głównej. Potwierdzenie wymaga sprawdzenia stanu funkcji systemowych i dzienników zdarzeń.

Rozdzielenie problemu WSL od problemu dystrybucji

W pierwszym etapie diagnostyki warto ustalić stan instalacji poleceniami wsl --status, wsl --version oraz wsl --list --verbose. Pierwsze polecenie pokazuje podstawowe informacje o konfiguracji WSL, drugie — wersję składników dostępnych w danym systemie, a trzecie pozwala sprawdzić zarejestrowane dystrybucje i używaną wersję WSL. Jeżeli błąd występuje przy każdej dystrybucji, bardziej prawdopodobna jest usterka wspólnej warstwy WSL lub platformy maszyny wirtualnej. Jeżeli dotyczy tylko jednej pozycji, należy dodatkowo zbadać jej stan i pliki systemu plików.

Pomocne jest także kontrolowane zatrzymanie środowiska poleceniem wsl --shutdown, a następnie ponowna próba uruchomienia. To usuwa działające instancje WSL z pamięci, lecz nie naprawia uszkodzonej dystrybucji ani nie zmienia jej danych. Stan funkcji opcjonalnych można sprawdzić poleceniem PowerShell Get-WindowsOptionalFeature -Online, ograniczając wynik do nazw związanych z WSL i platformą maszyny wirtualnej. W Podglądzie zdarzeń należy szukać informacji z dzienników dotyczących Hyper-V, Host Compute Service, systemu Windows oraz WSL. Treść błędu, kod towarzyszący i moment wystąpienia są ważniejsze niż sam ogólny identyfikator.

Postępowanie naprawcze i ocena konfiguracji

Naprawa powinna rozpoczynać się od czynności odwracalnych: ponownego uruchomienia systemu, sprawdzenia aktualizacji Windows, weryfikacji statusu WSL oraz potwierdzenia, że wirtualizacja sprzętowa jest aktywna. Nie należy od razu usuwać dystrybucji poleceniem wsl --unregister, ponieważ ta operacja kasuje jej lokalny system plików. Przed użyciem takiego polecenia trzeba wykonać kopię danych lub eksport dystrybucji, na przykład za pomocą wsl --export. Samo wyłączenie i ponowne włączenie funkcji systemowych również wymaga ostrożności, ponieważ może zmienić stan środowiska i wymagać restartu.

Jeżeli problem powtarza się mimo prawidłowego stanu składników, analiza powinna objąć integralność systemu Windows, sterowniki chipsetu i firmware komputera, konflikty z innymi mechanizmami wirtualizacyjnymi oraz dostępność zasobów sprzętowych. Warto odnotować model urządzenia, wydanie Windows, wersję WSL, wersję dystrybucji, wynik poleceń diagnostycznych i pełny komunikat z kodem dodatkowym.

Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów i komputerów PC, w tym diagnostyką problemów z oprogramowaniem systemowym oraz konfiguracją środowiska pracy na komputerze użytkownika.