Сообщение WSLRegisterDistribution failed with error 0x80070002
появляется при установке или первом запуске Linux-дистрибутива в WSL. Обычно это
значит, что Windows не может найти обязательный компонент, файл ядра или путь
для регистрации окружения.
Чаще всего проблема связана с отключёнными функциями WSL, сбоями Microsoft Store и повреждёнными системными компонентами. Последовательные шаги ниже помогают восстановить регистрацию без полной переустановки системы.
Почему возникает ошибка
- Отключены компоненты Windows Subsystem for Linux и VirtualMachinePlatform.
- Аппаратная виртуализация отключена в BIOS/UEFI.
- Повреждён кеш Store или пакет выбранного Linux-дистрибутива.
- Старое ядро WSL и конфликт версий после обновлений Windows.
- Проблемы доступа к профилю пользователя и папкам AppData/LocalState.
Способ 1. Проверить версию Windows и статус WSL
- Откройте PowerShell от имени администратора.
- Проверьте состояние WSL:
wsl --status
wsl -l -v- Убедитесь, что система поддерживает WSL 2.
Способ 2. Включить обязательные компоненты Windows
- В PowerShell от администратора выполните:
dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart- Перезагрузите компьютер после включения функций.
Способ 3. Обновить ядро WSL
- Запустите команды:
wsl --update
wsl --shutdown- После обновления повторите установку дистрибутива.
Способ 4. Сбросить кеш Microsoft Store
- Нажмите Win + R и введите:
wsreset.exe- После очистки кеша заново откройте Store и установите дистрибутив.
⚠️ Важно
Перед удалением установленного дистрибутива сохраните данные проекта. Команда удаления может безвозвратно удалить Linux-файловую систему.
Способ 5. Переустановить проблемный дистрибутив
- Посмотрите список дистрибутивов:
wsl -l -v- Удалите проблемный дистрибутив и установите заново через Store.
- Либо установите через консоль:
wsl --install -d UbuntuСпособ 6. Проверить системные файлы
- Выполните в CMD от администратора:
sfc /scannow
DISM /Online /Cleanup-Image /RestoreHealth- После завершения перезагрузите ПК и снова проверьте WSL.
Способ 7. Проверить виртуализацию и Hyper-V
- В диспетчере задач на вкладке «Производительность» проверьте Virtualization.
- Если отключено — включите VT-x/AMD-V в BIOS/UEFI.
- Для некоторых конфигураций включите платформу Hyper-V.
💡 Совет
Если WSL нужен для разработки, храните проекты в домашней директории Linux, а не в сетевых папках Windows — так меньше ошибок путей и прав доступа.
Способ 8. Обновление на месте при системных сбоях
- Смонтируйте актуальный ISO Windows 11/10.
- Запустите setup.exe с сохранением файлов и приложений.
- После обновления повторите
wsl --install.
Полезные пути
- Пакеты Store:
%localappdata%\Packages. -
Данные дистрибутива:
%localappdata%\Packages\*\LocalState. - Лог DISM:
%windir%\Logs\DISM\dism.log. - Лог SFC/CBS:
%windir%\Logs\CBS\CBS.log. -
Компоненты WSL:
%windir%\System32\lxss(в системных сборках).
FAQ
Почему появляется WSLRegisterDistribution failed with error 0x80070002?
Ошибка обычно означает, что WSL не находит нужные компоненты виртуализации, служебные файлы дистрибутива или корректный путь профиля. Часто проблема связана с отключёнными функциями WSL/VirtualMachinePlatform или повреждённым кэшем Microsoft Store.
Какие компоненты Windows должны быть включены для WSL?
Для корректной работы включите Windows Subsystem for Linux и Virtual Machine Platform, а также аппаратную виртуализацию в BIOS/UEFI. После включения обязательно перезагрузите компьютер.
Помогает ли команда wsl --update при 0x80070002?
Да, обновление ядра WSL через wsl --update часто устраняет несовместимость версий и отсутствующие файлы, из-за которых регистрация дистрибутива завершается ошибкой 0x80070002.
Нужно ли удалять и заново устанавливать дистрибутив Linux?
Если регистрация уже повреждена, удаление проблемного дистрибутива и его повторная установка через Store или wsl --install -d часто решает проблему. Перед удалением сохраните важные данные из файловой системы Linux.
Что делать, если ошибка остаётся после всех шагов?
Проверьте системные файлы SFC/DISM, сбросьте кеш Store и протестируйте установку в новом профиле Windows. В крайнем случае выполните обновление на месте, чтобы восстановить компоненты без удаления личных файлов.
В большинстве случаев ошибка WSLRegisterDistribution failed with error 0x80070002 устраняется после включения нужных функций Windows, обновления ядра WSL и переустановки дистрибутива. Последовательная проверка компонентов обычно возвращает рабочее Linux-окружение.