WSL 오류 0x8000FFFF(치명적 오류) 해결 — wsl --update와 시스템 파일 복구
0x8000FFFF는 WSL 구성 요소가 예기치 않게 실패한 경우입니다. Microsoft 문서는 관리자 권한으로 wsl --update → wsl --shutdown → SFC /SCANNOW → DISM 복구 순서로 실행하라고 안내합니다.
빠른 해결 요약
- 관리자 터미널 열기
- wsl --update, wsl --shutdown
- sfc /scannow
- DISM /Online /Cleanup-Image /RestoreHealth 후 재시작
이런 증상일 때 보는 글입니다
- WSL이 갑자기 0x8000FFFF로 실행되지 않을 때
해결 방법별 소요 시간·난이도·위험도
| 방법 | 소요 시간 | 난이도 | 관리자 권한 | 데이터·설정 위험 |
|---|---|---|---|---|
| WSL 업데이트 | 5분 | 쉬움 | 필요 | 없음 |
| 시스템 파일 복구 | 30분 | 쉬움 | 필요 | 없음 |
소요 시간은 일반적인 PC 기준 예상치이며 장치 상태에 따라 달라질 수 있습니다.
1단계: WSL 업데이트와 종료
실행 효과 WSL을 최신 버전으로 업데이트합니다.
PowerShell
wsl --update실행 효과 WSL을 완전히 종료합니다.
PowerShell
wsl --shutdown이후 배포판을 다시 실행해 봅니다. 대부분 이 단계에서 해결됩니다.
2단계: 시스템 파일 복구
실행 효과 손상된 Windows 시스템 파일을 검사·복구합니다(관리자).
명령 프롬프트
sfc /scannow실행 효과 Windows 구성 요소 저장소를 복구합니다(관리자, 시간이 걸림).
명령 프롬프트
DISM /Online /Cleanup-Image /RestoreHealth자세한 설명은 DISM·SFC 시스템 파일 복구 가이드에 있습니다. 끝나면 재시작합니다.
그래도 안 되면
Windows 기능에서 WSL과 가상 머신 플랫폼을 껐다가 재시작 후 다시 켜 봅니다. 배포판 데이터가 중요하다면 먼저 wsl --export 배포판이름 백업.tar로 백업해 둡니다.
자주 묻는 질문
배포판을 지우면 데이터도 사라지나요?
네. wsl --unregister는 해당 배포판의 파일을 모두 지웁니다. 백업 후 진행하세요.
다음으로 확인할 해결 가이드
시스템·블루스크린WSL 2 커널 구성 요소 업데이트 필요 오류 해결이 메시지는 WSL 2용 리눅스 커널이 설치되지 않았다는 뜻입니다. 관리자 터미널에서 wsl --update를 실행하면 최신 커널이 설치됩니다. 한국어 윈도우에서…시스템·블루스크린sfc /scannow·DISM 명령어 사용법 — 윈도우 시스템 파일 복구 순서Microsoft는 DISM을 먼저, SFC를 나중에 실행하도록 안내합니다. DISM이 복구에 쓸 원본(구성 요소 저장소)을 먼저 고치고, SFC가 그 원본으로 …시스템·블루스크린WSL 설치 방법 — wsl --install과 수동 설치WSL은 관리자 터미널에서 wsl --install 한 줄로 설치하는 것이 Microsoft 권장 방법입니다. 이 명령이 지원되지 않는 오래된 윈도우는 WSL 기…
이 글에서 다루는 오류 코드
0x8000FFFF
원인을 모르겠다면 증상을 선택해 해당 가이드로 이동하는 IT 오류 자가진단을 이용해 보세요.
공식 참고 문서
외부 링크는 현재 창에서 열립니다. 뒤로 가기로 이 글에 돌아올 수 있습니다.
이 방법으로 문제가 해결됐나요?