Docker, WSL, DB, Node.js, 패키지 의존성 등 개발·배포 환경에서 발생한 이슈.
현상: 프로젝트 초기 셋업 과정에서 npm install 실행 시 eslint 관련 peer dependency 충돌로 ERESOLVE 에러가 발생.
원인: eslint 패키지 간 버전 호환성 문제로 확인.
조치: 패키지 버전을 호환 가능한 조합으로 수정하여 해결. (PR #10, bc1592c)
현상: C드라이브 931GB 중 50MB만 잔여하여 시스템 전체가 마비.
원인: Docker Desktop의 docker_data.vhdx 파일이 482GB로 비대화. VHDX는 이미지 삭제 후에도 자동 축소되지 않음.
조치: VHDX compact 수행 후 Docker Desktop을 완전 제거하고 WSL 네이티브 Docker Engine으로 전환하여 482GB를 복구.
현상: Docker 컨테이너 재빌드 과정에서 Django 마이그레이션 실행이 실패.
원인: 0007_merge 두 개가 동일 의존성으로 존재.
조치: 중복 마이그레이션 파일을 삭제하여 해결.
현상: Mac에서 Tailscale을 통해 WSL 프론트엔드에 접근하는 과정에서 9건의 이슈가 연쇄적으로 발생.
| # | 이슈 | 원인 | 조치 |
|---|---|---|---|
| 1 | Next.js 실행 불가 | Node.js 18이 최소 요구(20.9.0) 미충족 | nvm Node 22 설치 |
| 2 | 패키지 설치 실패 | npm 캐시 손상(ENOENT) | npm cache clean --force |
| 3 | Mac에서 접근 불가 | Dev 서버 127.0.0.1 바인딩 | --hostname 0.0.0.0 추가 |
| 4 | API 호출 실패 | API Base URL localhost 고정 | .env.local에 Tailscale IP 설정 |
| 5 | Admin CSS 깨짐 | gunicorn static 미서빙 | whitenoise 미들웨어 도입 |
| 6 | API 요청 차단 | CSRF/CORS에 Tailscale IP 미등록 | .env.docker 업데이트 |
| 7 | ImageField 크래시 | Pillow 미설치 | requirements.txt 추가 |
| 8 | 지도 API 차단 | 카카오 Map API 도메인 미등록 | 개발용 도메인 등록 |
| 9 | env 변경 미반영 | docker compose restart는 env 미재로드 |
down && up 사용 |