6️⃣ 실전 팁과 자주 하는 실수 정리

6️⃣ 실전 팁과 자주 하는 실수 정리

---

📌 Docker 캐시 클리어 빌드

• 이미지 빌드 시 이전 캐시가 남아 문제가 발생할 수 있음
• docker compose build --no-cache 명령어로 캐시 무시하고 빌드 권장

---

📌 환경변수 누락 문제

• DJANGO_SETTINGS_MODULE 미설정 시 기본 설정을 불러와 오류 유발
• docker-compose.yml에 반드시 environment로 명시할 것
• 컨테이너 내 echo $DJANGO_SETTINGS_MODULE로 설정 확인

---

📌 경로 문제

• BASE_DIR이 프로젝트 최상위 디렉터리 정확히 가리키도록 설정
• base.py 내 BASE_DIR = Path(__file__).resolve().parent.parent.parent 등
• STATIC_ROOT는 BASE_DIR 기준 하위 경로 지정

---

📌 정적파일 404 문제

• STATIC_URL을 항상 절대경로(/static/)로 설정
• django.template.context_processors.static 템플릿 설정 포함
• 개발환경에서는 urls.py에 static() 함수로 정적파일 서빙 추가

---

📌 배포 시 주의사항

• 운영 환경 DEBUG=False 설정 필수
• Nginx 등 별도 웹서버로 정적파일 서빙 담당
• 민감정보는 환경변수 등으로 안전 관리

---

🔥 마무리 팁

• 프로젝트 시작 전 환경 변수와 경로 설정을 꼼꼼히 체크하세요
• 컨테이너 내 직접 확인하는 습관이 문제 예방에 매우 효과적입니다
• 문서화하여 팀원과 공유하면 실수 방지에 도움됩니다