Windows 컴퓨터에서 WSL(Windows Subsystem for Linux)을 시작할 때 "오류 0x80370102: 필수 기능이 설치되어 있지 않기 때문에 가상 머신을 시작할 수 없습니다"라는 메시지가 표시된다면, 아래 단계를 따라 문제를 해결할 수 있습니다. 이 오류는 Hyper-V를 비활성화한 상태에서 WSL2를 사용하려고 할 때 특히 자주 발생합니다.
WslRegisterDistribution failed with error: 0x80370102.
오류 0x80370102: 필수 기능이 설치되어 있지 않기 때문에 가상 머신을 시작할 수 없습니다.
WSL은 컴퓨터에서 정상적으로 동작하기 위해 Hyper-V와 가상화 기능이 반드시 활성화되어 있어야 합니다. WSL을 설정한 이후에도 실수로 이러한 기능 중 하나를 꺼두었다면, WSL을 시작할 때 위와 같은 오류가 나타날 수 있습니다.
오류 0x80370102 해결 방법
오류 0x80370102를 수정하려면 다음 네 가지 단계를 순서대로 진행하세요.
- Hyper-V 활성화
- 하드웨어 가상화 활성화
- 중첩 가상화(Nested Virtualization) 활성화
- 가상 머신 플랫폼(Virtual Machine Platform) 켜기
각 단계의 자세한 내용은 아래에서 계속 설명합니다.
1] Hyper-V 활성화
이 문제를 해결하기 위해 가장 먼저 확인해야 할 부분입니다. Hyper-V는 Windows에서 WSL을 사용하기 위해 반드시 필요한 기능입니다. 다음 절차에 따라 Hyper-V를 활성화하세요.
- 작업 표시줄의 검색 상자를 클릭합니다.
- turn windows features on or off(Windows 기능 켜기/끄기)를 입력합니다.
- 검색 결과를 클릭해 창을 엽니다.
- 목록에서 Hyper-V 항목을 찾습니다.
- 해당 확인란에 체크합니다.
- 확인 버튼을 클릭합니다.
- 설치가 완료될 때까지 기다린 뒤 컴퓨터를 재시작합니다.
완료되면 별도의 문제 없이 WSL을 사용할 수 있습니다.
2] 하드웨어 가상화 활성화
Hyper-V 기반의 WSL을 PC에서 구동하려면 하드웨어 가상화가 켜져 있어야 합니다. WSL 설치 후 실수로 비활성화했다면 BIOS 설정에서 이 기능을 다시 활성화해야 합니다. 설정을 변경하기 전에 작업 관리자를 열고 성능 탭으로 이동하면 가상화 항목을 통해 현재 상태를 확인할 수 있습니다.
상태가 사용으로 표시되어 있는지 확인하고, 그렇지 않다면 BIOS/UEFI 설정에서 Intel VT-x 또는 AMD-V 기반의 하드웨어 가상화를 활성화해야 합니다.
3] 중첩 가상화 활성화
가상 Windows 머신 위에 WSL을 설치해 사용하는 경우에는 중첩 가상화를 켜야 합니다. 사용하는 가상 머신 소프트웨어에 따라 설정 경로가 조금씩 다를 수 있지만, VMware나 VirtualBox 등 대부분의 주요 가상화 도구에는 유사한 옵션이 제공됩니다.
4] 가상 머신 플랫폼 켜기
가상 머신 플랫폼은 WSL 시작 시 오류 0x80370102를 해결하기 위해 반드시 활성화해야 하는 또 다른 필수 기능입니다. 활성화 방법은 다음과 같습니다.
- 작업 표시줄 검색 상자에서 turn windows features on or off(Windows 기능 켜기/끄기)를 검색합니다.
- 검색 결과를 클릭합니다.
- 가상 머신 플랫폼 옵션을 찾습니다.
- 해당 확인란에 체크합니다.
- 확인 버튼을 클릭합니다.
- 설치가 완료되면 컴퓨터를 재부팅합니다.
이후 PC에서 WSL을 다시 실행해 정상적으로 동작하는지 확인하세요.
자주 묻는 질문
오류 0x80370102는 어떻게 해결하나요?
Windows 11/10 PC에서 오류 0x80370102를 해결하려면 앞서 안내한 방법들을 모두 적용해야 합니다. Windows 기능 패널에서 Hyper-V와 가상 머신 플랫폼을 켜고, 하드웨어 가상화가 활성화되어 있는지 확인하세요. 가상 머신 환경에서 WSL을 사용한다면 중첩 가상화도 함께 켜야 합니다.
이상입니다! 이 가이드가 오류 없이 WSL을 사용하는 데 도움이 되기를 바랍니다.