🐳 Docker가 Engine Starting에서 멈췄을 때의 해결기 (WSL2 삽질 로그)

💡 이 글은 Django + Docker + MySQL 개발 환경을 구축하는 과정에서
Docker가 Engine Starting... 상태에서 무한 대기되던 문제를
하루 종일 삽질하며 해결한 생생한 기록입니다.

 

---

🔧 환경 정보

항목	내용
OS	Windows 11
Docker Desktop	최신 버전
WSL2	사용 중
MySQL	Docker 컨테이너 (포트 3307)
프로젝트	Django 백엔드 API 서버 개발 중

 

---

😱 문제 상황

🐳 Docker Desktop이 켜지지 않음

• 실행하면 계속
  👉 Starting the Docker Engine...
  으로만 표시되고 절대 "Engine Running" 상태로 바뀌지 않음

🔍 터미널에서 확인한 문제

wsl --list --verbose

 

결과:

 

docker-desktop    Stopped    2

Docker 내부의 WSL 백엔드가 꺼져 있어서 Docker가 정상적으로 실행되지 못하는 상태

---

🧪 시도했던 방법 (실패)

• Docker 강제 종료 후 재실행
• 관리자 권한으로 실행
• wsl --shutdown 해도 변화 없음
• 재설치 없이 해결하고 싶었음

---

✅ 최종 해결 방법

📌 관리자 권한 CMD에서 다음 명령어 실행

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

⚠️ 꼭 관리자 권한으로 실행해야 하고,
✅ 명령어가 성공한 후에는 재부팅 필수!

---

🔁 재부팅 후 확인

wsl --list --verbose

 

이제 아래처럼 떠야 함:

docker-desktop    Running    2

그리고 Docker Desktop 실행 시
Engine running 정상 확인됨! 🎉

---

🐝 나처럼 겪을 수 있는 사람들을 위해

이 문제는 나처럼 Windows + Docker + MySQL 컨테이너 환경에서 개발하려는 사람이라면
거의 한 번은 겪게 되는 문제다.

✅ 이 글이 같은 상황에서 고생하는 개발자에게 도움이 되기를 바란다.
(특히 Docker를 처음 쓰거나, Django 프로젝트 환경 세팅 중인 동지들…)