[Django] django-debug-toolbar 오류 해결 (Setting을 전부 했는데 toolbar가 안 뜬다.)

Django 프로젝트에서 django-debug-toolbar가 웹 창에 보이지 않는 상황이 발생할 수 있습니다. 이 글에서는 해당 문제를 해결하는 방법을 단계별로 설명합니다.

[Step]

1. 개발자 도구(F12)로 상태 확인

먼저, 브라우저의 개발자 도구(F12)를 열어 djDebugToolbar가 djdt-hidden 상태인지 확인해보세요.

만약 djdt-hidden 상태라면, 툴바가 렌더링되었지만 숨겨져 있다는 의미입니다.

2. 강력 새로고침 (Ctrl + F5)

djdt-hidden 상태라면 가장 먼저 Ctrl + F5를 눌러 강력 새로고침을 시도해보세요.

브라우저 캐시로 인해 잘못된 MIME 타입이 계속 로드될 수 있습니다.

브라우저 캐시를 삭제하거나 강력 새로고침을 시도하면 문제가 해결될 수 있습니다. (저는 이 방법으로 해결되었습니다.)

3. JavaScript 관련 에러 확인 및 수정

문제가 해결되지 않았다면, 자바스크립트 관련 에러일 가능성이 있습니다.

다음 코드를 urls.py에 추가하여 JavaScript MIME 타입 문제를 해결해보세요:

if DEBUG:
    import mimetypes
    mimetypes.add_type("application/javascript", ".js", True)

이 코드는 JavaScript 파일의 MIME 타입을 명시적으로 지정하여, 브라우저가 올바르게 인식하도록 합니다.

4. Django 설정 확인

위의 방법으로도 해결되지 않는다면, Django의 설정을 다시 확인해보세요.

특히 정적 파일(Static Files)이 올바르게 제공되고 있는지 확인해야 합니다.

1. settings.py에서 STATICFILES_DIRS와 STATIC_ROOT가 올바르게 설정되었는지 확인합니다.
2. 정적 파일을 수집하는 명령어를 다시 실행합니다:
3. python manage.py collectstatic
4. Django 서버를 다시 시작하여 문제가 해결되었는지 확인합니다.

이 단계를 통해 django-debug-toolbar가 웹 페이지에 정상적으로 표시될 것입니다.