4️⃣ Django 템플릿과 정적파일 연동
📌 context_processors 설정의 중요성
- Django 템플릿에서 {% static 'path/to/file' %} 태그가 정상 작동하려면
TEMPLATES 설정의 OPTIONS.context_processors에
'django.template.context_processors.static'이 반드시 포함돼야 함 - 누락 시 정적파일 경로가 잘못 생성되어 404 오류 발생 가능
📌 템플릿 내 정적 파일 참조법
- {% load static %} 태그로 static 템플릿 태그 로드
- <link href="{% static 'admin/css/base.css' %}" rel="stylesheet"> 와 같이 사용
- 하드코딩된 경로 사용을 피하고, STATIC_URL 변경에도 유연하게 대응 가능
📌 urls.py에서 정적 파일 서빙 설정
- 개발 모드(DEBUG=True)에서는 urls.py에 다음을 추가해 Django가 직접 static 파일을 서빙하도록 함
from django.conf import settings
from django.conf.urls.static import static
urlpatterns = [
# 기존 url 패턴
]
if settings.DEBUG:
urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
📌 초기 문제 및 해결
- django.template.context_processors.static 미포함으로 정적파일이 상대경로로 요청되어 404 발생
- 위 설정 추가 후 경로 문제 해결
- urls.py에 static 서빙 추가로 개발서버에서 직접 정적파일 제공 가능
📌 실무 팁
- 운영환경에서는 DEBUG=False이므로 별도 웹서버로 정적파일 서빙 위임
- 개발환경에서는 위 설정으로 편리하게 테스트 가능
'프로젝트' 카테고리의 다른 글
6️⃣ 실전 팁과 자주 하는 실수 정리 (0) | 2025.06.06 |
---|---|
5️⃣ 운영과 개발 환경 구분 및 배포 준비 (0) | 2025.06.06 |
3️⃣ Static 파일 처리 문제와 해결 (0) | 2025.06.06 |
2️⃣ 환경 변수 및 설정 관리 (0) | 2025.06.06 |
1️⃣ 프로젝트 개요 및 초기 세팅 문제 (0) | 2025.06.06 |