WSL2 nie rozpoznaje sterownika Vulkan

WSL2 nierozpoznający sterownika Vulkan wskazuje na brak skonfigurowanej akceleracji GPU dla podsystemu Linux w Windows.

Co oznacza brak rozpoznania sterownika Vulkan w WSL2

Komunikat informujący, że WSL2 nie rozpoznaje sterownika Vulkan, oznacza zwykle, że aplikacja uruchomiona w dystrybucji Linux nie może znaleźć kompletnego środowiska potrzebnego do utworzenia instancji Vulkan. Vulkan nie jest pojedynczym sterownikiem instalowanym wyłącznie wewnątrz systemu Linux. Do działania potrzebuje zgodnego sterownika GPU po stronie Windows, komponentów udostępniających kartę graficzną w WSL2 oraz bibliotek przestrzeni użytkownika i pliku ICD, czyli opisu sterownika Vulkan wykorzystywanego przez loader.

W WSL2 dostęp do układu graficznego odbywa się przez mechanizm GPU paravirtualization. W środowisku Linux widoczny może być interfejs /dev/dxg, natomiast właściwa obsługa sprzętu zależy także od sterownika zainstalowanego w Windows. Samo zainstalowanie pakietu o nazwie zawierającej „Vulkan” w dystrybucji Linux nie naprawi problemu, jeżeli sterownik Windows jest nieaktualny, nie obsługuje wymaganej funkcji albo komponenty WSL są niespójne.

Warstwy wymagane do uruchomienia aplikacji Vulkan

Pierwszą warstwą jest aktualny WSL2 oraz jego komponenty graficzne. Można sprawdzić stan środowiska poleceniami wsl --status i wsl --version uruchomionymi w PowerShellu lub w wierszu polecenia Windows. Polecenie wsl --update aktualizuje komponent WSL, o ile system i sposób instalacji WSL pozwalają na pobranie aktualnej wersji. Po aktualizacji przydatne bywa wykonanie wsl --shutdown, które zatrzymuje wszystkie działające instancje WSL2; następne uruchomienie dystrybucji załaduje środowisko ponownie.

Drugą warstwą jest sterownik karty graficznej dla Windows. Musi on pochodzić od producenta GPU i zawierać obsługę używaną przez WSL2. Trzecią warstwą są biblioteki Linux, między innymi loader Vulkan oraz odpowiedni sterownik użytkownika. Loader wyszukuje pliki ICD, zwykle w katalogach takich jak /usr/share/vulkan/icd.d/ lub /etc/vulkan/icd.d/. Brak pliku ICD, niezgodna architektura pakietu albo wskazanie nieistniejącej biblioteki może powodować komunikat o nierozpoznanym sterowniku, nawet gdy sama karta graficzna jest poprawnie widoczna w Windows.

Rozróżnienie problemu Windows, WSL2 i biblioteki Linux

Diagnostykę należy rozpocząć od ustalenia, czy problem dotyczy całego WSL2, czy tylko jednej aplikacji. Jeżeli ls -l /dev/dxg zwraca informację o braku pliku, środowisko nie uzyskało oczekiwanego interfejsu GPU. Nie jest to jednak dowód, że karta graficzna jest uszkodzona. Przyczyną może być niewłaściwa wersja WSL2, uruchomienie dystrybucji w innym trybie, niezgodny sterownik Windows albo ograniczenie konkretnego środowiska sprzętowego.

Jeżeli urządzenie jest dostępne, należy sprawdzić loader i enumerację urządzeń. W dystrybucji Linux można użyć polecenia vulkaninfo --summary, jeżeli pakiet narzędzi Vulkan jest zainstalowany. Wynik może wskazać brak loadera, brak pliku ICD, błąd ładowania biblioteki lub poprawnie wykryty adapter. Warto również wyświetlić zawartość katalogów ICD poleceniem find /usr/share/vulkan/icd.d /etc/vulkan/icd.d -maxdepth 1 -type f 2>/dev/null. Gdy problem występuje tylko w jednym programie, trzeba dodatkowo sprawdzić jego wymagania dotyczące wersji Vulkan, architektury procesu, zmiennych środowiskowych oraz sposobu wyboru urządzenia.

Postępowanie przy przywracaniu obsługi Vulkan

Naprawa powinna zachować kolejność zależności. Najpierw aktualizuje się WSL2 i sterownik GPU w Windows, następnie restartuje środowisko poleceniem wsl --shutdown, a dopiero potem weryfikuje pakiety Vulkan w konkretnej dystrybucji. Nie należy kopiować plików ICD z przypadkowych instalacji ani wymuszać ścieżki do biblioteki za pomocą zmiennej VK_ICD_FILENAMES, jeśli nie ma pewności, że plik opisuje właściwy sterownik. Takie działanie może zamaskować prawdziwą przyczynę i spowodować błędy ładowania w innych programach.

Jeżeli aktualizacja nie pomaga, należy porównać wynik diagnostyki przed i po ponownym uruchomieniu WSL, sprawdzić dzienniki aplikacji oraz ustalić, czy używana dystrybucja ma kompletne pakiety loadera i narzędzi Vulkan. W przypadku laptopa istotny może być także wybór aktywnego układu graficznego przez Windows, szczególnie gdy komputer ma zintegrowany i dedykowany GPU. Warszawskie Pogotowie Komputerowe wykonuje profesjonalną naprawę laptopów i komputerów PC, obejmującą diagnostykę sterowników, konfiguracji systemu Windows, środowiska WSL2 oraz podzespołów odpowiedzialnych za obsługę grafiki.