🔧 WSL2 문제 해결 가이드

[Tae4an]

❌ 문제 상황

"WSL2는 현재 컴퓨터 구성에서 지원되지 않습니다."

🚨 오류 메시지

Wsl/Service/RegisterDistro/CreateVm/HCS/HCS_E_HYPERV_NOT_INSTALLED

🔍 주요 원인 분석

1. BIOS에서 가상화 기능 비활성화
2. Windows 가상 머신 플랫폼 미설정
3. WSL 업데이트 필요

💊 단계별 해결 방법

1️⃣ BIOS 가상화 활성화

⚠️ 주의: BIOS 설정은 제조사별로 다를 수 있습니다!

설정 단계

1. 🔄 컴퓨터 재시작
2. ⌨️ Delete 또는 F2 키로 BIOS 진입
3. 🔧 가상화 설정 변경:

   Advanced Mode → OC → Advanced CPU Configuration
   → SVM Mode: Enabled
   

4. 💾 F10으로 저장 후 재시작

2️⃣ Windows 가상화 설정

Windows 기능 활성화

1. 🔍 Windows 검색창에서 "Windows 기능 켜기/끄기" 검색
2. ✅ 필수 항목 체크:
   • 가상 머신 플랫폼
   • Windows 하위 시스템 for Linux
3. 🔄 시스템 재시작 필요

3️⃣ WSL 업데이트

PowerShell 관리자 모드에서 실행:

# WSL 업데이트
wsl --update

# WSL 설치 (배포판 제외)
wsl --install --no-distribution

4️⃣ Docker Desktop 재설치

1. 🗑️ 기존 설치 제거
2. 🧹 임시 파일 정리
3. 🔄 시스템 재시작
4. 📥 최신 버전 설치

✅ 문제 해결 체크리스트

단계	확인사항	상태
1	BIOS 가상화 활성화	⬜
2	Windows 가상화 기능 설정	⬜
3	WSL 업데이트 완료	⬜
4	Docker Desktop 정상 실행	⬜

🛠️ 추가 문제해결 도구

가상화 상태 확인

1. Ctrl + Shift + Esc로 작업 관리자 실행
2. 성능 탭 선택
3. CPU 섹션에서 "가상화: 사용" 확인

유용한 WSL 명령어

# 버전 확인
wsl --version

# 상태 확인
wsl --status

# WSL 재시작
wsl --shutdown

💡 문제 지속 시 추가 조치

• 📥 Windows 최신 업데이트 설치
• 🛡️ 바이러스 백신 일시 중지 후 테스트
• 🔄 시스템 전체 재시작
• 🆘 기술 지원 문의