WSL 2 nie działa po aktualizacji systemu

WSL 2 niedziałający po aktualizacji systemu wskazuje na konflikt komponentu jądra Linux z nową wersją Windows — wymaga aktualizacji przez wsl --update.

WSL 2 nie działa po aktualizacji systemu – czym jest ten problem

Komunikat „WSL 2 nie działa po aktualizacji systemu” oznacza, że środowisko Windows Subsystem for Linux w wersji 2 przestało poprawnie uruchamiać dystrybucję Linuksa albo nie potrafi już połączyć jej z wymaganym komponentem systemowym. Nie musi to oznaczać uszkodzenia samych plików użytkownika. Częściej przyczyną jest zmiana sposobu działania usług, sterowników, funkcji wirtualizacji sprzętowej lub pakietu jądra Linux dostarczanego przez Windows.

WSL 2 działa inaczej niż starsza wersja WSL. Dystrybucja nie korzysta wyłącznie z warstwy tłumaczącej polecenia, lecz uruchamia lekkie środowisko wykorzystujące jądro Linux oraz mechanizmy izolacji dostępne w Windows. Po większej aktualizacji systemu jeden z tych elementów może zostać wyłączony, zastąpiony starszą wersją albo pozostawać w stanie niezgodnym z pozostałymi składnikami. Objawem bywa zatrzymanie startu na określonym procencie, błąd inicjalizacji, brak dostępu do systemu plików lub zamknięcie terminala zaraz po uruchomieniu dystrybucji.

Warto odróżnić awarię samego WSL 2 od problemu konkretnej dystrybucji. Jeżeli nie uruchamia się tylko Ubuntu, Debian lub inny wybrany system, przyczyna może znajdować się w jego konfiguracji, uprawnieniach albo plikach systemowych. Jeżeli nie działa żadna dystrybucja, bardziej prawdopodobny jest problem z funkcjami Windows, jądrem WSL, usługą odpowiedzialną za maszyny wirtualne lub ustawieniami firmware komputera.

WSL 2 nie działa po aktualizacji systemu – kontekst techniczny i porównania

Najważniejszą różnicą między WSL 1 a WSL 2 jest sposób wykonywania programów Linux. WSL 1 odwzorowuje wybrane wywołania systemowe w środowisku Windows, natomiast WSL 2 korzysta z rzeczywistego jądra Linux uruchamianego w odseparowanym środowisku. Dzięki temu zgodność z wieloma narzędziami deweloperskimi jest większa, ale rośnie liczba elementów, które muszą współpracować. Aktualizacja Windows może zmienić wersję jądra, ustawienia platformy maszyn wirtualnych, polityki bezpieczeństwa, obsługę sieci albo sposób montowania dysków.

Typowe znaczenie mają trzy warstwy. Pierwsza to sam interfejs poleceń wsl.exe, który przyjmuje komendy zarządzające dystrybucjami. Druga to pakiet jądra WSL 2 i jego składniki aktualizowane niezależnie od pełnego obrazu Windows. Trzecia obejmuje funkcje systemowe, takie jak Podsystem Windows dla systemu Linux oraz Platforma maszyny wirtualnej. Brak lub niespójność któregoś z tych elementów może prowadzić do komunikatów sugerujących, że wymagany komponent nie jest dostępny.

Przydatne jest sprawdzenie stanu środowiska poleceniem wsl --status. Pozwala ono zobaczyć między innymi domyślną wersję, informacje o jądrze i podstawową konfigurację. Polecenie wsl --version może pokazać wersje poszczególnych składników w nowszych wydaniach Windows. Gdy dane wskazują na nieaktualne jądro, zwykle pierwszym bezpiecznym krokiem jest wsl --update. Po zakończeniu aktualizacji może być potrzebne ponowne uruchomienie systemu, ponieważ część usług jest ładowana dopiero podczas startu Windows.

Nie należy utożsamiać problemu z każdą awarią terminala. PowerShell, Wiersz polecenia i aplikacje terminalowe mogą działać prawidłowo, mimo że WSL 2 jest niesprawny. Z kolei brak dostępu do sieci wewnątrz dystrybucji może wynikać z zapory, oprogramowania ochronnego lub zmian w konfiguracji DNS, nawet jeśli sama dystrybucja startuje bez błędu.

WSL 2 nie działa po aktualizacji systemu – typowe problemy i objawy

Jednym z częstszych objawów jest komunikat o konieczności aktualizacji jądra Linux. W takiej sytuacji system rozpoznaje WSL 2, ale nie ma właściwej albo wystarczająco nowej wersji komponentu. Pomocne może być wykonanie wsl --update, a następnie wsl --shutdown i ponowne uruchomienie wybranej dystrybucji. Jeżeli aktualizacja nie może zostać pobrana, trzeba sprawdzić dostęp do sieci, usługę Windows Update oraz ograniczenia nałożone przez ustawienia zabezpieczeń.

Inna grupa błędów dotyczy wyłączonych funkcji systemu. Po aktualizacji mogą one zostać zmienione, szczególnie gdy przywracano ustawienia domyślne, modyfikowano polityki zabezpieczeń albo korzystano z narzędzi do odchudzania instalacji Windows. W takim przypadku WSL 2 może zgłaszać brak wymaganej funkcji, nieoczekiwane zakończenie procesu lub problem z uruchomieniem środowiska. Weryfikacja składników powinna obejmować Podsystem Windows dla systemu Linux oraz Platformę maszyny wirtualnej. Zmiany warto wykonywać świadomie i po zapisaniu ważnych danych.

Problem może pojawić się również po aktualizacji firmware albo zmianie ustawień UEFI. WSL 2 wymaga dostępności sprzętowych mechanizmów wirtualizacji, dlatego ich wyłączenie może uniemożliwić start środowiska mimo poprawnej instalacji pakietu. Niekiedy system działał przed aktualizacją, ponieważ ustawienie było aktywne, lecz po przywróceniu konfiguracji firmware zostało wyłączone. Weryfikacja powinna być wykonana zgodnie z dokumentacją płyty głównej lub komputera.

Do innych objawów należą: zniknięcie dystrybucji z listy, status „stopped” mimo próby uruchomienia, bardzo długi start, brak dostępu do katalogów Windows, błędy montowania dysków, niedziałająca nazwa hosta, brak połączenia sieciowego lub problemy z Docker Desktop korzystającym z zaplecza WSL 2. Każdy z tych przypadków wymaga odrębnego rozpoznania. Ponowna instalacja całego systemu bez sprawdzenia logów może usunąć dane i nie rozwiązać przyczyny.

WSL 2 nie działa po aktualizacji systemu – praktyczne wskazówki

Przed rozpoczęciem naprawy warto zanotować dokładny komunikat błędu, nazwę dystrybucji, wersję Windows oraz moment, w którym problem się pojawił. Informacja, czy awaria nastąpiła po zwykłej aktualizacji jakościowej, aktualizacji funkcji, zmianie sterownika czy restarcie po instalacji, pomaga zawęzić obszar poszukiwań. Dobrze jest także sprawdzić, czy problem występuje na nowo utworzonej dystrybucji, ale nie należy usuwać obecnej dystrybucji przed wykonaniem kopii danych.

Do podstawowej kopii można wykorzystać polecenie wsl --export, zapisując zawartość dystrybucji do pliku archiwum w bezpiecznym miejscu. Przywracanie wykonuje się dopiero po upewnieniu się, że archiwum jest dostępne i ma odpowiedni rozmiar. Szczególnej ostrożności wymagają katalogi projektów, klucze SSH, pliki konfiguracyjne, bazy danych oraz dane przechowywane poza standardowym katalogiem użytkownika.

Po aktualizacji należy sprawdzić kolejno status WSL, wersję jądra, listę dystrybucji oraz ich wersję działania. Przydatne polecenia to wsl --list --verbose, wsl --status i wsl --update. W przypadku zawieszenia środowiska można użyć wsl --shutdown, który zamyka uruchomione instancje i pozwala rozpocząć pracę od czystego stanu. Nie powinno się jednak wielokrotnie wykonywać przypadkowych poleceń naprawczych bez obserwowania rezultatu, ponieważ utrudnia to ustalenie, która zmiana wpłynęła na działanie systemu.

Jeżeli WSL 2 uruchamia się, lecz nie działa sieć, należy porównać zachowanie poleceń rozpoznawania nazw, sprawdzić plik konfiguracji DNS i zweryfikować, czy zapora nie blokuje procesu. Gdy problem dotyczy dostępu do plików, warto sprawdzić uprawnienia, sposób montowania katalogu oraz różnice między ścieżką Linux a ścieżką Windows. Wydajność może spadać przy intensywnej pracy na plikach przechowywanych w zamontowanym katalogu Windows, dlatego projekty wymagające częstych operacji wejścia i wyjścia lepiej przechowywać w lokalizacji zgodnej z używanym środowiskiem.

WSL 2 nie działa po aktualizacji systemu – kiedy zgłosić się do serwisu

Pomoc serwisowa jest wskazana, gdy aktualizacja jądra nie przynosi rezultatu, funkcje systemowe są niedostępne, komputer zgłasza błędy wirtualizacji albo problem powtarza się po każdym ponownym uruchomieniu. Dotyczy to także sytuacji, w której WSL 2 jest potrzebny do pracy projektowej, a samodzielne próby naprawy mogłyby naruszyć dane dystrybucji. Przed przekazaniem sprzętu dobrze przygotować opis objawów, nazwę używanej dystrybucji i informację o ostatniej aktualizacji.

Warszawskie Pogotowie Komputerowe 24/7 może przeanalizować konfigurację Windows, sprawdzić zależności WSL 2, zweryfikować ustawienia firmware i ocenić, czy źródłem awarii jest system, sterownik, dysk lub konfiguracja użytkownika. Rozpoznanie powinno zacząć się od zabezpieczenia danych i odczytania komunikatów, a dopiero później obejmować naprawę składników. Takie podejście ogranicza ryzyko pochopnego usunięcia dystrybucji lub utraty plików zapisanych w jej systemie plików.

Zgłoszenie warto rozważyć również wtedy, gdy po aktualizacji pojawiły się równocześnie inne symptomy: samoczynne restarty, błędy dysku, spowolnienie uruchamiania Windows, problemy z siecią lub nieprawidłowe działanie sterowników. WSL 2 może być wtedy tylko jednym z objawów szerszej usterki. Prawidłowa diagnoza powinna uwzględnić stan systemu, nośnika danych, pamięci operacyjnej i ustawień startowych, a także rozdzielić problem środowiska Linux od ewentualnych problemów samego Windows.