WSL 오류 0x80370102 해결 — '필요한 기능이 설치되지 않아 가상 머신을 시작할 수 없습니다'
0x80370102는 WSL 2를 돌릴 가상화 기능이 꺼져 있다는 뜻입니다. BIOS에서 가상화(Intel VT-x·AMD SVM)를 켜고, Windows 기능에서 가상 머신 플랫폼을 켠 뒤 재시작합니다. 그래도 같다면 hypervisorlaunchtype이 Auto인지 확인합니다.
빠른 해결 요약
- 작업 관리자 → 성능 → CPU에서 '가상화: 사용' 확인
- 꺼져 있으면 BIOS에서 Intel VT-x / AMD SVM 켜기
- Windows 기능에서 '가상 머신 플랫폼' 체크 → 재시작
- 관리자 명령으로 hypervisorlaunchtype 확인
이런 증상일 때 보는 글입니다
- wsl --install 후 우분투 실행 시 0x80370102가 뜰 때
- 도커 데스크톱 설치 후 WSL이 안 될 때
해결 방법별 소요 시간·난이도·위험도
| 방법 | 소요 시간 | 난이도 | 관리자 권한 | 데이터·설정 위험 |
|---|---|---|---|---|
| 가상화 확인 | 1분 | 쉬움 | 필요 없음 | 없음 |
| BIOS 가상화 켜기 | 10분 | 보통 | - | 낮음 |
| 가상 머신 플랫폼 | 5분 | 쉬움 | 필요 | 재시작 |
| hypervisorlaunchtype | 3분 | 보통 | 필요 | 부팅 설정 변경 |
소요 시간은 일반적인 PC 기준 예상치이며 장치 상태에 따라 달라질 수 있습니다.
1단계: 가상화가 켜져 있는지
Ctrl+Shift+Esc → 성능 → CPU 화면 오른쪽 아래의 '가상화' 항목을 봅니다. '사용 안 함'이면 BIOS에서 꺼져 있는 것입니다. Microsoft 문서에 따르면 WSL 2는 SLAT를 지원하는 CPU가 필요해 아주 오래된 CPU에서는 동작하지 않습니다.
2단계: BIOS에서 가상화 켜기
바이오스에 들어가(제조사별 바이오스 키) CPU 설정의 Intel Virtualization Technology(VT-x) 또는 AMD SVM Mode를 Enabled로 바꾸고 저장합니다.
3단계: 가상 머신 플랫폼
Win+R → optionalfeatures(Windows 기능 켜기/끄기)에서 '가상 머신 플랫폼'과 'Linux용 Windows 하위 시스템'을 체크하고 재시작합니다. 명령으로는 다음과 같습니다.
실행 효과 가상 머신 플랫폼 기능을 켭니다(관리자 PowerShell).
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart4단계: hypervisorlaunchtype 확인
실행 효과 하이퍼바이저 실행 설정을 확인합니다(관리자). Off로 나오면 다음 명령을 실행합니다.
bcdedit /enum | findstr -i hypervisorlaunchtype실행 효과 하이퍼바이저를 부팅 시 자동 실행으로 되돌립니다. 실행 후 재시작합니다.
bcdedit /set hypervisorlaunchtype Auto다른 가상화 프로그램
Microsoft 문서는 VMware 15.5.5 이상, VirtualBox 6 이상으로 업데이트하거나 해당 프로그램의 하이퍼바이저를 끄라고 안내합니다. 가상 머신 안에서 WSL을 돌린다면 중첩 가상화를 켜야 합니다.
자주 묻는 질문
가상화를 켜면 게임 성능이 떨어지나요?
일반적인 사용에서 체감 차이는 크지 않습니다. 일부 오래된 안티치트·가상화 프로그램과 충돌할 수 있습니다.
다음으로 확인할 해결 가이드
이 글에서 다루는 오류 코드
0x80370102
원인을 모르겠다면 증상을 선택해 해당 가이드로 이동하는 IT 오류 자가진단을 이용해 보세요.
공식 참고 문서
외부 링크는 현재 창에서 열립니다. 뒤로 가기로 이 글에 돌아올 수 있습니다.
이 방법으로 문제가 해결됐나요?