적용 범위: Windows의 WSL · 공식 자료 확인: 2026-10-20
어떤 단계에서 실패했는지 먼저 확인하세요
WSL(Windows Subsystem for Linux) 관련 업데이트나 배포판 설치 중 오류가 발생하면 진행이 멈추거나 네트워크, 변환 작업에서 실패할 수 있습니다. 다만 wsl --update 실패와 Ubuntu 안에서 실행한 sudo apt update 실패는 서로 다른 작업입니다. 아래에서는 주요 점검 항목인 가상화, Windows 기능, 호스트 네트워크 서비스, 커널 업데이트를 증상에 맞춰 나눠 확인합니다.
이 글은 Microsoft 공식 문서를 정리한 진단 안내이며, 특정 PC에서 오류를 직접 재현해 해결했다고 보고하는 글은 아닙니다. 오류 코드와 실행한 명령을 함께 기록하고, 해당하는 단계만 확인하세요.
1. 오류 문구와 현재 상태를 기록합니다
Windows PowerShell 또는 명령 프롬프트에서 다음 조회 명령을 한 줄씩 실행합니다. Linux 터미널에 그대로 붙여넣는 절차가 아닙니다.
wsl --version
wsl --status
wsl --list --verbose
첫 명령은 WSL 구성 요소 버전, 두 번째는 기본 배포·커널 등 상태, 세 번째는 배포별 WSL 1/2 여부와 실행 상태를 확인합니다. 오래된 기본 제공 WSL에서 --version을 인식하지 못하면 wsl --status와 wsl --help 결과를 기록하세요. Microsoft: WSL 기본 명령 및 공식 문제 해결 문서를 참고했습니다.
2. WSL 자체 업데이트가 실패한 경우
저장하지 않은 작업을 먼저 보관한 뒤 Windows의 명령창에서 아래 업데이트를 실행하고, 완료 또는 실패 문구를 확인하세요. 관리자 권한이 필요하다는 안내가 나오면 권한이 있는 계정에서 관리자 명령창을 사용합니다.
wsl --update
Microsoft Store를 통한 업데이트 경로에서 문제가 생기고 현재 WSL이 해당 옵션을 지원한다면 다음 공식 대안을 검토할 수 있습니다.
wsl --update --web-download
--web-download는 Store 대신 GitHub에서 업데이트를 받는 옵션입니다. 모든 오류를 해결하는 명령은 아니며, 조직 PC에서는 다운로드 정책을 먼저 확인하세요. 지원하지 않는 옵션이라는 메시지가 나오면 반복 실행하지 말고 현재 Windows·WSL 버전과 도움말을 확인합니다. Microsoft의 업데이트 명령 설명
3. 설치·실행 오류라면 해당 조건만 점검합니다
- 가상화·Virtual Machine Platform:
0x80370102처럼 가상 머신 시작에 필요한 기능이 없다는 오류일 때 확인합니다. BIOS/UEFI 설정은 PC 제조사 안내를 따르고, 기능을 활성화했다면 재부팅합니다. - Windows 선택적 기능:
0x8007019e는 WSL 선택적 구성 요소가 활성화되지 않은 경우의 점검 항목입니다. 모든 업데이트 오류가 같은 기능 누락 때문이라고 단정하지 마세요. - 커널 업데이트 패키지: 구형 수동 설치 환경에서 커널 구성 요소 업데이트가 필요하다는 문구가 나온 경우 구형 WSL 수동 설치 안내의 해당 절차와 CPU 아키텍처를 확인합니다. 최신 설치 환경에 구형 패키지를 무조건 적용하지 않습니다.
오류별 근거: Microsoft WSL 문제 해결 — 설치 오류
4. 배포판 내부 DNS 오류는 별도로 진단합니다
Ubuntu 등의 패키지 업데이트 중 도메인을 해석하지 못한다는 문구가 나온다면 WSL 자체 업데이트 성공 여부와 구분하세요. Windows에서도 인터넷이 안 되는지, WSL 안에서만 실패하는지, VPN 연결 때만 발생하는지를 기록하면 문의 범위를 줄일 수 있습니다.
ICS(인터넷 연결 공유) 등 호스트 네트워크 서비스는 네트워크 증상에 맞춰 확인할 사항입니다. DNS 파일 수정이나 서비스 재시작을 모든 사용자에게 공통 해결책으로 적용하지 않습니다. 공식 문서도 VPN, 방화벽, DNS 터널링 등 환경별로 다른 절차를 안내합니다. 특히 /etc/resolv.conf를 임의로 고정하면 현재 DNS 구성과 충돌할 수 있으므로, 먼저 공식 문서의 해당 네트워크 항목을 확인하고 조직 PC는 관리자에게 문의하세요.
5. 재시작과 완료 확인
WSL 재시작이 필요한 상황이라면 Linux 작업과 WSL을 사용하는 앱의 작업을 저장한 뒤 아래 명령을 검토할 수 있습니다. 이 명령은 실행 중인 모든 배포판과 WSL 2 가상 머신을 종료하므로 실행 중인 작업이 중단됩니다.
wsl --shutdown
이후 사용하는 배포판을 다시 엽니다. 버전과 상태는 Windows PowerShell 또는 명령 프롬프트에서 wsl --version 또는 wsl --status로 확인하세요. 처음 실패한 작업은 그 작업을 실행했던 환경에서 한 번 다시 시도합니다. 특정 서비스 이름을 전제로 한 재시작보다 공식 종료 명령의 적용 범위를 먼저 확인하세요. Microsoft: WSL 종료·상태 명령
주의 사항과 추가 문의
Windows 인플레이스 업그레이드는 일반적인 WSL 업데이트 실패의 기본 해결 단계로 권하지 않습니다. Windows 자체 손상이 확인된 경우에만 별도 복구 절차와 백업을 검토하세요. 배포판 등록 해제 명령은 해당 배포판의 데이터를 영구 삭제하므로 업데이트 문제 해결용으로 따라 실행하지 마세요.
완료 기준: 업데이트 결과뿐 아니라 원래 사용하던 배포판과 실패했던 작업이 정상 동작하는지 확인합니다. 해결되지 않으면 실행 명령, 오류 문구·코드, Windows 빌드, WSL 버전, 배포판 이름, VPN 사용 여부, 시도한 조치와 결과를 정리해 문의하세요. 공유할 화면이나 로그에서는 사용자명·내부 주소·인증 정보를 가립니다.
자주 묻는 질문
Ubuntu의 apt 오류도 wsl --update로 해결되나요?
서로 다른 업데이트이므로 해결을 보장할 수 없습니다. Windows의 WSL 업데이트와 Linux 배포판의 패키지 업데이트 중 어디서 오류가 났는지 구분하세요.
종료 명령을 실행하면 배포판이 삭제되나요?
wsl --shutdown은 실행 중인 환경을 종료하는 명령입니다. 배포판 등록 해제와는 다르지만 저장하지 않은 작업은 잃을 수 있으므로 먼저 보관하세요.