WSL 설치 오류 0x80040306 해결 — 레거시 콘솔 끄기
0x80040306은 Microsoft 문서 기준으로 명령 프롬프트의 '레거시 콘솔 사용'이 켜져 있을 때 납니다. 명령 프롬프트 제목 표시줄을 마우스 오른쪽 클릭 → 속성에서 레거시 콘솔 사용 체크를 해제하고 다시 설치합니다.
빠른 해결 요약
- 명령 프롬프트(cmd) 실행
- 제목 표시줄 우클릭 → 속성
- '레거시 콘솔 사용' 체크 해제 → 확인
- 배포판 다시 설치·실행
이런 증상일 때 보는 글입니다
- WSL 배포판 설치가 0x80040306으로 실패할 때
해결 방법별 소요 시간·난이도·위험도
| 방법 | 소요 시간 | 난이도 | 관리자 권한 | 데이터·설정 위험 |
|---|---|---|---|---|
| 레거시 콘솔 해제 | 2분 | 쉬움 | 필요 없음 | 없음 |
소요 시간은 일반적인 PC 기준 예상치이며 장치 상태에 따라 달라질 수 있습니다.
1단계: 레거시 콘솔 끄기
시작에서 cmd를 실행하고 창 위 제목 표시줄을 마우스 오른쪽 클릭 → 속성 → 옵션 탭 아래쪽의 레거시 콘솔 사용(다시 시작해야 함) 체크를 해제합니다. 확인을 누른 뒤 창을 닫습니다.
2단계: 다시 설치
관리자 터미널에서 wsl --install을 다시 실행하거나 시작 메뉴에서 배포판을 실행합니다(WSL 설치 방법).
Windows 터미널 사용
Windows 터미널은 최신 콘솔을 사용하므로 이런 문제가 적습니다. Microsoft Store에서 무료로 설치할 수 있고, Windows 11에는 기본 포함돼 있습니다.
레거시 콘솔이란
오래된 프로그램 호환을 위해 예전 방식의 콘솔을 쓰는 옵션입니다. WSL의 리눅스 터미널 기능은 최신 콘솔을 필요로 하므로 이 옵션이 켜져 있으면 설치·실행에 실패합니다.
자주 묻는 질문
다른 오류 코드가 나오면요?
WSL 설치 방법의 오류 표를 참고하세요.
다음으로 확인할 해결 가이드
시스템·블루스크린WSL 설치 방법 — wsl --install과 수동 설치WSL은 관리자 터미널에서 wsl --install 한 줄로 설치하는 것이 Microsoft 권장 방법입니다. 이 명령이 지원되지 않는 오래된 윈도우는 WSL 기…시스템·블루스크린WSL 0x8007019e 오류 해결 방법0x8007019e는 'Linux용 Windows 하위 시스템' 기능이 켜져 있지 않을 때 납니다. Win+R → optionalfeatures(Windows 기…시스템·블루스크린WSL 0x8000FFFF 오류 해결 방법0x8000FFFF는 WSL 구성 요소가 예기치 않게 실패한 경우입니다. Microsoft 문서는 관리자 권한으로 wsl --update → wsl --shutd…
이 글에서 다루는 오류 코드
0x80040306
원인을 모르겠다면 증상을 선택해 해당 가이드로 이동하는 IT 오류 자가진단을 이용해 보세요.
공식 참고 문서
외부 링크는 현재 창에서 열립니다. 뒤로 가기로 이 글에 돌아올 수 있습니다.
이 방법으로 문제가 해결됐나요?