Błąd WSL 2 requires an update to its kernel component

Niebieski ekran (BSOD) i błędy krytyczne jądra systemu diagnozujemy na podstawie kodu zatrzymania i zrzutu pamięci — pozwala to ustalić, czy przyczyną jest sterownik, sprzęt czy uszkodzony plik systemowy.

Czym jest komunikat „WSL 2 requires an update to its kernel component”

Komunikat „WSL 2 requires an update to its kernel component” oznacza, że podsystem Windows dla systemu Linux nie może uruchomić środowiska WSL 2, ponieważ brakuje aktualnego składnika jądra używanego do obsługi lekkiej maszyny wirtualnej. WSL 2 nie działa wyłącznie jako warstwa tłumacząca polecenia Linuksa na funkcje Windows. Korzysta z rzeczywistego jądra Linuksa uruchamianego w izolowanym środowisku, dlatego jego zgodność z wersją systemu Windows ma bezpośrednie znaczenie dla startu dystrybucji.

Problem pojawia się najczęściej po instalacji dystrybucji, zmianie wersji systemu Windows, przywróceniu systemu z kopii albo wyłączeniu części aktualizacji. Samo zainstalowanie aplikacji „Windows Subsystem for Linux” nie zawsze wystarcza. Potrzebny może być osobny pakiet aktualizacyjny jądra WSL, nowsza wersja komponentu WSL dostępna przez Windows Update albo przełączenie środowiska na właściwą wersję architektury.

Wystąpienie tego komunikatu nie musi oznaczać uszkodzenia plików dystrybucji. Jest to przede wszystkim informacja o braku, niezgodności lub nieprawidłowym zarejestrowaniu elementu potrzebnego do uruchomienia WSL 2. Z tego powodu przed usuwaniem dystrybucji, resetowaniem systemu lub kasowaniem katalogów z danymi warto ustalić, czy problem dotyczy samego składnika WSL, mechanizmu wirtualizacji, usługi systemowej czy konfiguracji konkretnej dystrybucji.

Kontekst techniczny i porównanie WSL 1 z WSL 2

WSL 1 i WSL 2 korzystają z odmiennego modelu działania. Pierwsza wersja zapewnia warstwę zgodności pozwalającą uruchamiać wiele narzędzi linuksowych bez pełnego jądra Linuksa. WSL 2 używa jądra dostarczanego przez firmę Microsoft i uruchamia środowisko w oparciu o funkcje wirtualizacji systemu Windows. Dzięki temu uzyskuje wyższą zgodność z zachowaniem typowym dla Linuksa, ale jednocześnie wymaga poprawnie zainstalowanych oraz aktywnych dodatkowych komponentów.

Na uruchomienie WSL 2 wpływa kilka warstw konfiguracji: funkcja „Podsystem Windows dla systemu Linux”, platforma maszyny wirtualnej, wersja systemu Windows, pakiet jądra WSL oraz ustawienie określające domyślną wersję nowych dystrybucji. Błąd może zostać wyświetlony wtedy, gdy jedna z tych warstw została pominięta, jest starsza od pozostałych albo została wyłączona po aktualizacji. Niekiedy jądro jest obecne, lecz system nie może go poprawnie zarejestrować z powodu nieukończonej aktualizacji lub błędów magazynu składników.

W praktyce sprawdza się między innymi wersję systemu Windows, stan opcjonalnych funkcji, wynik polecenia wsl --status, listę dystrybucji oraz ich wersję za pomocą wsl --list --verbose. Przydatne może być także polecenie wsl --update, jednak jego skuteczność zależy od wersji systemu, dostępu do usługi aktualizacji i prawidłowego działania wymaganych funkcji. Zmiana ustawienia dystrybucji z WSL 2 na WSL 1 może być rozwiązaniem tymczasowym, ale nie zastępuje naprawy środowiska, jeżeli potrzebne są funkcje dostępne wyłącznie w WSL 2.

Ważne jest rozróżnienie między aktualizacją jądra a aktualizacją dystrybucji Linuksa. Aktualizacja pakietów wewnątrz Ubuntu, Debian lub innego środowiska nie naprawia brakującego komponentu WSL po stronie Windows. Obie warstwy mogą wymagać osobnej obsługi, a ich pomieszanie często prowadzi do powtarzania nieskutecznych poleceń.

Typowe problemy i błędy towarzyszące - Błąd WSL 2 requires an update to its kernel component

Najczęstszą przyczyną komunikatu jest nieaktualna wersja WSL lub brak pakietu jądra. Zdarza się również, że system został zaktualizowany tylko częściowo, a wymagane funkcje opcjonalne pozostały w stanie oczekiwania na ponowne uruchomienie. W takiej sytuacji kolejne próby uruchomienia dystrybucji mogą kończyć się tym samym komunikatem, mimo że część plików aktualizacji znajduje się już na dysku.

Inny scenariusz dotyczy wyłączonej platformy maszyny wirtualnej albo ustawień oprogramowania układowego komputera. WSL 2 wymaga środowiska umożliwiającego uruchamianie izolowanych składników systemowych. Jeżeli funkcje wirtualizacyjne są niedostępne, zablokowane lub nie zostały prawidłowo załadowane, aktualizacja samego jądra może nie wystarczyć. Należy wtedy sprawdzić stan funkcji Windows, ustawienia firmware oraz ewentualne ograniczenia wprowadzone przez zasady systemowe.

Problemy mogą pojawić się także po ręcznym usunięciu plików, zmianie uprawnień, przeniesieniu katalogu dystrybucji albo odtworzeniu profilu użytkownika. W takich przypadkach polecenia WSL mogą zwracać dodatkowe kody, informować o braku dystrybucji lub zatrzymywać się na etapie montowania systemu plików. Błąd jądra może być wtedy tylko pierwszym widocznym objawem szerszej niespójności konfiguracji.

Nie zaleca się pochopnego używania poleceń usuwających dystrybucję, ponieważ operacja wyrejestrowania może usunąć zapisane w niej dane, projekty, konfiguracje i pakiety. Przed resetem warto zabezpieczyć pliki znajdujące się w środowisku Linux oraz ustalić, czy dane są przechowywane w systemie plików dystrybucji, w katalogach Windows, czy w podłączonych woluminach. Ostrożności wymaga również ręczne kasowanie katalogów związanych z WSL, gdyż może utrudnić późniejszą naprawę.

W diagnostyce bierze się pod uwagę między innymi historię aktualizacji, stan usług systemowych, komunikaty w Podglądzie zdarzeń, dostępność funkcji wirtualizacyjnych, uprawnienia użytkownika oraz wynik uruchomienia WSL po restarcie. Dopiero zestawienie tych informacji pozwala odróżnić brak aktualizacji od uszkodzenia komponentów systemu, błędnej konfiguracji lub konfliktu z innym oprogramowaniem zabezpieczającym.

Kiedy najlepiej zlecić diagnozę specjalistom - Błąd WSL 2 requires an update to its kernel component

Zgłoszenie do serwisu jest uzasadnione, gdy standardowa aktualizacja WSL nie przywraca działania, funkcje opcjonalne nie chcą się włączyć, system wielokrotnie żąda ponownego uruchomienia albo polecenia diagnostyczne zwracają różne błędy przy każdej próbie. Pomoc może być potrzebna również wtedy, gdy na komputerze znajdują się ważne środowiska programistyczne, kontenery, repozytoria lub dane, których nie powinno się narażać na utratę podczas resetowania dystrybucji.

W ramach zgłoszenia analizuje się wersję Windows, sposób zainstalowania WSL, stan wymaganych funkcji, logi aktualizacji oraz konfigurację dystrybucji. Następnie można uporządkować komponenty WSL, przeprowadzić bezpieczną aktualizację jądra, przywrócić prawidłowe ustawienia funkcji systemowych i zweryfikować uruchamianie dystrybucji. Jeżeli problem wynika z szerszych błędów systemu, sprawdza się również integralność plików Windows oraz wpływ sterowników lub narzędzi zabezpieczających.

Do serwisu komputerowego w Warszawie można zgłosić laptopa z komunikatem dotyczącym WSL 2, a diagnoza LAPTOPA jest darmowa. Przed przekazaniem urządzenia warto podać dokładną treść komunikatu, nazwę używanej dystrybucji, informację o ostatniej aktualizacji oraz wskazać, czy w środowisku znajdowały się ważne pliki. Takie dane ułatwiają rozpoczęcie pracy od właściwego obszaru i ograniczają ryzyko wykonania czynności, które mogłyby usunąć lokalne dane.

Jeżeli WSL jest używany do nauki, tworzenia oprogramowania, obsługi narzędzi serwerowych lub pracy z kontenerami, przywrócenie środowiska powinno obejmować także test poleceń, dostęp do plików, działanie sieci oraz możliwość ponownego uruchomienia dystrybucji po restarcie systemu. Sama instalacja brakującego pakietu nie zawsze oznacza pełne usunięcie przyczyny, dlatego końcowa weryfikacja działania ma znaczenie równie duże jak sama aktualizacja.