Skip to content

Docker WSL ERROR

Jump to bottom
SeoJungHun edited this page Dec 6, 2024 · 7 revisions

다음은 요청하신 대로 일관된 틀과 형식으로 정리된 마크다운 문서입니다:

✅ WSL 오류 해결 가이드

이 문서는 WSL 설치 및 업데이트 중 발생하는 주요 오류, 특히 다음과 같은 문제를 해결하기 위한 방법을 제공합니다:

  • "클래스가 등록되지 않았습니다" (REGDB_E_CLASSNOTREG)
  • 오류 코드: exit code 0xffffffff (4294967295)
  • wsl update failed

1️⃣ 기본 해결 방법

1. Windows 기능 활성화

WSL과 가상 머신 플랫폼이 활성화되지 않았을 수 있습니다. 아래 절차를 따라 확인하세요:

  1. Windows 검색창에 Windows 기능 켜기/끄기를 입력하고 실행.
  2. 아래 항목을 체크:
    • Windows Subsystem for Linux
    • Virtual Machine Platform
  3. 확인 후 컴퓨터를 재부팅.

2. 시스템 파일 복구 (DISM 및 SFC 도구)

시스템 파일 손상 문제를 해결하려면:

  1. PowerShell을 관리자 권한으로 실행.
  2. 아래 명령어 실행: 
    dism /online /cleanup-image /restorehealth
sfc /scannow
  3. 완료 후 컴퓨터 재부팅.

3. WSL 설치 상태 확인

  1. PowerShell을 관리자 권한으로 실행.
  2. 현재 설치된 WSL 상태 확인: 
    wsl --list --verbose
  3. 오류가 발생하거나 설치되지 않았다면 WSL을 다시 설치: 
    wsl --install

4. Windows 업데이트 확인

  1. Windows 설정 > Windows 업데이트로 이동.
  2. 사용 가능한 업데이트를 모두 설치 후 재부팅.

2️⃣ 심화 해결 방법

1. WSL 구성 요소 재등록

WSL 실행과 관련된 레지스트리 문제를 해결하기 위해:

  1. PowerShell을 관리자 권한으로 실행.
  2. 아래 명령어 실행: 
    regsvr32 C:\WINDOWS\System32\wsl.exe

2. 레지스트리 직접 수정

  1. Windows 검색창에 레지스트리 편집기를 입력하고 실행.
  2. 아래 경로로 이동: 
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\wsl.exe
  3. 해당 경로가 없거나 잘못 설정되어 있다면 올바르게 수정.

3. Windows Subsystem for Linux 업데이트 패키지 수동 설치

  1. Microsoft WSL GitHub 릴리스 다운로드
  2. wsl --list --verbose

3️⃣ 추가 문제 해결: Docker 및 WSL 통합

Docker Desktop 사용 중 "Virtual Machine Platform not enabled" 오류가 발생할 경우:

  1. PowerShell을 관리자 권한으로 실행.
  2. 아래 명령어 입력: 
    Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
  3. 완료 후 재부팅.

4️⃣ 마무리 확인

  1. PowerShell에서 WSL 설치 상태 확인: 
    wsl --list --verbose
  2. WSL 기본 버전을 2로 설정: 
    wsl --set-default-version 2
  3. 문제가 지속될 경우 Docker와의 통합 설정 확인.

참고 링크

위 단계를 통해 대부분의 오류를 해결할 수 있습니다. 추가적으로 오류 로그나 상황을 제공해 주시면 더 구체적인 도움을 드릴 수 있습니다.

Clone this wiki locally