itfixIT 오류 해결 가이드
윈도우

wsl --install --update 실패 오류 코드별 5단계 실전 해결 가이드

wsl --install이나 wsl --update가 0x80370102, 0x8007019e, 0x80070003 같은 오류로 실패할 때 오류 코드별 원인과 가상화·구성 요소·저장 위치·웹 다운로드 설치로 해결하는 방법입니다.

itfix 작성2026년 10월 11일 게시약 8분 소요

wsl –install –update 실패 원인과 핵심 요약

WSL 설치와 업데이트 실패는 화면에 나오는 오류 코드로 원인이 거의 정해집니다. 0x80370102는 가상화가 꺼져 있거나 하이퍼바이저가 시작되지 않은 경우, 0x8007019e는 WSL 구성 요소가 꺼진 경우, 0x80070003은 배포판이 시스템 드라이브가 아닌 곳에 설치되려는 경우이며, 마이크로소프트 스토어가 막힌 환경이라면 웹 다운로드 방식으로 설치할 수 있습니다.

아래 명령 대부분은 관리자 권한 PowerShell이 필요하고, 구성 요소를 켠 뒤에는 재부팅해야 적용됩니다. 진행 중인 작업을 먼저 저장하세요.

증상별 바로가기

지금 상황 바로 갈 곳
오류 코드를 모르겠다, 상태부터 보고 싶다 해결 방법 1
0x80370102 오류가 나온다 해결 방법 2
0x8007019e 오류가 나온다 해결 방법 3
다운로드가 멈추거나 스토어 오류가 난다 해결 방법 4
0x80070003 오류가 나온다 해결 방법 5

해결 방법 1: 오류 코드와 현재 상태 확인

  1. 시작 메뉴에서 PowerShell을 검색해 관리자 권한으로 실행합니다.

  2. 실패한 명령을 다시 실행해 오류 메시지의 코드(0x로 시작하는 값) 를 그대로 적어 둡니다.

  3. 현재 WSL 상태를 확인합니다.

    wsl --status

  4. 버전을 확인합니다. 이 명령이 인식되지 않으면 윈도우에 기본 포함된 오래된 WSL입니다. 4번 방법으로 최신 WSL을 설치하면 됩니다.

    wsl --version

  5. 적어 둔 오류 코드에 맞는 해결 방법으로 이동합니다.

해결 방법 2: 0x80370102 가상화와 하이퍼바이저

“필요한 기능이 설치되지 않아 가상 머신을 시작할 수 없습니다”라는 뜻입니다.

  1. Ctrl + Shift + Esc로 작업 관리자를 열고 성능 탭의 CPU에서 가상화가 사용인지 확인합니다. 사용 안 함이라면 BIOS(UEFI)에서 가상화(인텔 VT-x, AMD SVM 등)를 켭니다. 위치는 메인보드마다 다르며 대개 CPU 관련 메뉴에 있습니다.

  2. 가상 머신 플랫폼 구성 요소를 켭니다.

    Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

  3. 하이퍼바이저가 부팅 때 시작되도록 설정되어 있는지 확인합니다.

    bcdedit /enum | findstr -i hypervisorlaunchtype

  4. 결과가 Off라면 켭니다.

    bcdedit /set hypervisorlaunchtype Auto

  5. 재부팅한 뒤 다시 설치합니다.

  6. VMware나 VirtualBox가 설치되어 있다면 최신 버전으로 업데이트하거나 종료한 상태에서 시도합니다. 오래된 버전은 충돌할 수 있습니다.

bcdedit는 부팅 구성을 바꾸는 명령입니다. 위에 적힌 hypervisorlaunchtype 값 외에는 바꾸지 마세요. 잘못 바꾸면 윈도우가 부팅되지 않을 수 있습니다.

해결 방법 3: 0x8007019e WSL 구성 요소 켜기

배포판 등록 과정에서 “WslRegisterDistribution failed with error 0x8007019e”가 나오면 WSL 구성 요소가 꺼져 있다는 뜻입니다.

  1. 관리자 권한 PowerShell에서 WSL 구성 요소를 켭니다.

    Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

  2. 같은 방식으로 가상 머신 플랫폼도 켜져 있는지 확인합니다.

    Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform

  3. 명령 대신 화면에서 하려면 Windows + R에서 optionalfeatures를 실행해 Linux용 Windows 하위 시스템과 가상 머신 플랫폼을 체크합니다.

  4. 재부팅한 뒤 wsl --install을 다시 실행합니다.

해결 방법 4: 스토어 대신 웹 다운로드로 설치

회사망이나 정책으로 마이크로소프트 스토어가 막혀 있으면 설치나 업데이트가 멈춥니다.

  1. 설치는 스토어를 거치지 않고 온라인 원본에서 받도록 지정합니다.

    wsl --install --web-download

  2. 업데이트는 GitHub에서 최신 버전을 받도록 지정합니다.

    wsl --update --web-download

  3. 설치 가능한 배포판 목록을 확인하려면 아래 명령을 씁니다.

    wsl --list --online

  4. 원하는 배포판을 이름으로 지정해 설치할 수 있습니다. 아래 Ubuntu는 목록에 나온 이름으로 바꿉니다.

    wsl --install -d Ubuntu --web-download

  5. 그래도 다운로드 자체가 실패한다면 회사 방화벽·프록시가 GitHub 다운로드도 막고 있는 것입니다. IT 담당자에게 문의하세요.

해결 방법 5: 0x80070003 저장 위치를 시스템 드라이브로

WSL 배포판은 시스템 드라이브(보통 C)에서만 동작합니다. 새 앱 저장 위치를 D 드라이브 등으로 바꿔 두었다면 이 오류가 납니다.

  1. [설정 > 시스템 > 저장소]로 이동합니다.
  2. 고급 저장소 설정을 펼치고 새 콘텐츠가 저장되는 위치를 엽니다.
  3. 새 앱 저장 위치를 C 드라이브로 바꿉니다.
  4. 설치를 다시 시도합니다.
  5. 메뉴 명칭은 윈도우 버전에 따라 다를 수 있습니다. 설정 검색창에 “저장 위치”를 입력해 찾으세요.

문제 해결이 안 될 경우 추가 점검 사항

  • 오래된 CPU: WSL 2는 가상화 주소 변환(SLAT)을 지원하는 CPU가 필요합니다. 아주 오래된 CPU에서는 구성 요소를 켜도 동작하지 않습니다.
  • 압축·암호화된 폴더: 배포판 폴더에 압축이나 암호화가 걸려 있으면 가상 디스크 오류가 납니다. 해당 폴더의 속성에서 압축과 암호화를 해제하세요.
  • 가상 머신 안에서 실행: 가상 머신 안의 윈도우에서 WSL을 쓰려면 호스트 쪽에서 중첩 가상화를 켜야 합니다.
  • 설치 후 인터넷 안 됨: 설치는 됐는데 리눅스 안에서 인터넷이 안 된다면 WSL2 인터넷 DNS 안 됨 글을 확인하세요.
  • Docker와 함께 쓸 때: Docker Desktop이 멈춘다면 Docker Desktop Starting the Docker Engine 무한 로딩 글을 이어서 확인하세요.

자주 묻는 질문

회사 PC라 BIOS에서 가상화를 켤 수 없어요.

BIOS 설정은 사용자가 바꿀 수 없는 경우가 많습니다. 가상화가 꺼져 있으면 WSL 2는 동작하지 않으므로, IT 담당자에게 가상화 활성화가 가능한지 문의하세요.

WSL을 완전히 지우고 처음부터 다시 설치하고 싶어요.

wsl --unregister 배포판이름 명령으로 배포판을 지울 수 있지만, 그 배포판 안의 파일과 설정이 모두 영구 삭제됩니다. 필요한 파일을 먼저 윈도우 쪽으로 복사하거나 wsl --export로 백업한 뒤 진행하세요.

이 문서는 2026년 10월 11일 기준으로 작성되었습니다. 운영체제 업데이트에 따라 메뉴 명칭과 위치가 달라질 수 있으며, 시스템 설정을 변경하기 전에는 중요한 데이터를 먼저 백업하시기 바랍니다.

윈도우 개발 환경 오류 전체