WSL2 설치 오류 0x80370102 해결: 가상화·가상 머신 플랫폼·하이퍼바이저 점검

WSL2 설치 오류 0x80370102 해결: 가상화·가상 머신 플랫폼·하이퍼바이저 점검

작성자:

윈도우에서 wsl --install로 우분투를 설치했는데, 첫 실행에서 아래 같은 메시지와 함께 멈추는 경우가 많습니다.

WslRegisterDistribution failed with error: 0x80370102
Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS.

WSL2는 내부적으로 경량 가상 머신 위에서 리눅스 커널을 돌립니다. 그래서 CPU 가상화(BIOS) → 윈도우 기능 → 하이퍼바이저 실행 세 단계 중 하나라도 꺼져 있으면 이 오류가 납니다. 아래 순서대로 확인하면 대부분 해결됩니다.

오류 코드별로 먼저 짚어 보기

오류 코드뜻바로 볼 곳
0x80370102가상 머신을 시작할 수 없음1~3단계 (BIOS 가상화, 가상 머신 플랫폼, 하이퍼바이저)
0x8007019eWSL 기능 자체가 꺼져 있음2단계
0x800701bcWSL2 커널 구성 요소 업데이트 필요4단계 (wsl --update)

1. BIOS에서 CPU 가상화가 켜져 있는지 확인

가장 흔한 원인입니다. 작업 관리자(Ctrl+Shift+Esc) → 성능 → CPU 화면 오른쪽 아래의 가상화 항목을 봅니다.

  • 사용으로 나오면 BIOS는 정상입니다. 2단계로 넘어갑니다.
  • 사용 안 함이면 재부팅해서 BIOS/UEFI 설정으로 들어가 켭니다. 이름은 제조사마다 다릅니다. 인텔은 Intel Virtualization Technology (VT-x), AMD는 SVM Mode로 표시되는 경우가 많고, 보통 Advanced → CPU Configuration 아래에 있습니다.

노트북 중에는 BIOS에서 이 항목이 Security 메뉴 아래에 숨어 있는 경우도 있습니다. 저장(F10) 후 재부팅하고 작업 관리자에서 다시 확인합니다.

2. 윈도우 기능 두 가지 켜기

WSL2에는 Linux용 Windows 하위 시스템과 가상 머신 플랫폼 두 기능이 모두 필요합니다. 관리자 권한 PowerShell에서 실행합니다.

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

두 줄 모두 “작업을 완료했습니다”가 나오면 반드시 재부팅합니다. 화면으로 하려면 제어판 → 프로그램 → Windows 기능 켜기/끄기에서 같은 이름의 두 항목에 체크하면 됩니다.

3. 하이퍼바이저 실행 설정 되돌리기

BIOS와 기능이 다 켜져 있는데도 0x80370102가 나면, 예전에 다른 가상화 프로그램이나 일부 게임·보안 도구 때문에 하이퍼바이저 실행이 꺼져 있을 수 있습니다. 관리자 명령 프롬프트에서 현재 값을 확인합니다.

bcdedit /enum {current}

결과에 hypervisorlaunchtype Off가 있으면 다음 명령으로 되돌리고 재부팅합니다.

bcdedit /set hypervisorlaunchtype auto

재부팅 후 systeminfo를 실행했을 때 맨 아래 Hyper-V 항목에 “하이퍼바이저가 검색되었습니다”라는 문구가 보이면 정상입니다.

4. WSL 업데이트와 기본 버전 지정

기능을 켠 뒤에는 WSL 자체를 최신으로 맞춥니다. 0x800701bc는 이 단계로 해결됩니다.

wsl --update
wsl --set-default-version 2
wsl --install -d Ubuntu

이미 설치가 반쯤 된 배포판이 있다면 wsl --unregister Ubuntu로 지운 뒤 다시 설치하는 편이 깔끔합니다. 이 명령은 해당 배포판 안의 파일을 모두 지우므로, 설치 직후 처음 실행 단계에서만 쓰세요.

5. 정상 설치 확인

wsl --version
wsl -l -v

wsl -l -v 결과에서 배포판의 VERSION이 2로 나오면 끝입니다. 1로 나오면 wsl --set-version Ubuntu 2로 바꿉니다. WSL2 위에서 GPU를 쓰는 AI 환경을 만들 계획이라면 RTX 50 시리즈 PyTorch CUDA 세팅 글로 이어서 진행하면 됩니다.

자주 묻는 질문

  • 가상 머신 안의 윈도우에서 WSL2를 쓰려면? 호스트에서 중첩 가상화를 켜야 합니다. Hyper-V 호스트라면 VM을 끈 상태에서 Set-VMProcessor -VMName "VM이름" -ExposeVirtualizationExtensions $true를 실행합니다. 다른 가상화 프로그램은 각자의 중첩 가상화 옵션을 켜야 합니다.
  • VirtualBox·VMware와 같이 써도 되나요? 최신 버전은 윈도우 하이퍼바이저 위에서 함께 동작합니다. 오래된 버전은 충돌하므로 최신으로 업데이트하세요.
  • 윈도우 Home에서도 되나요? 됩니다. WSL2와 가상 머신 플랫폼은 Home에서도 지원합니다. Hyper-V 관리자 같은 일부 도구만 Pro 이상 전용입니다.

댓글 남기기