Django 프론트& 백엔드 개발

ROOT_URLCONF의 역할

Data Jun 2026. 1. 3. 15:28

Django에서 브라우저로부터 요청이 들어오면
가장 먼저 확인하는 파일이 있습니다.
바로 ROOT_URLCONF로 지정된 프로젝트의 urls.py 입니다.

 

1. ROOT_URLCONF란?

settings.py에는 다음과 같은 설정이 있습니다.

ROOT_URLCONF = 'costaurant.urls'

이 설정은 Django에게 이렇게 알려줍니다.

“URL 요청이 들어오면
가장 먼저 costaurant/urls.py 파일을 확인해라.”

즉, 모든 URL 요청의 출발점입니다

 

2. 요청 흐름에서의 위치

브라우저에서 요청이 들어오면 Django는 다음 순서로 처리합니다.

 

예시)

  • HTTP 요청 수신
  • ROOT_URLCONF 확인
  • 지정된 프로젝트 urls.py 로 이동
  • 경로에 따라 App의 urls.py로 분기
  • View 함수 실행
  • HTTP Response 반환

3. 왜 프로젝트 urls.py가 먼저일까?

  • Django는 프로젝트 단위로 서버를 실행
  • 여러 App을 하나의 서비스로 묶어야 함
  • 그래서 중앙 라우터 역할이 필요

 이 역할을 하는 것이 프로젝트의 urls.py 입니다.

 

4. 정리하면

ROOT_URLCONF는
“URL 요청의 첫 관문을 어디로 할지 정하는 설정”이다