The Django Request-Response Cycle

Understanding how Django processes an HTTP request is fundamental to building applications correctly. When a request arrives, Django's WSGI/ASGI handler passes it through the middleware stack. Middleware components can inspect, modify, or short-circuit the request before it reaches the view. Common middleware handles sessions, authentication, CSRF protection, and security headers. After middleware processing, Django's URL dispatcher (URLconf) matches the request path against patterns defined in urls.py files. The first pattern that matches determines which view function or class is called. The URL dispatcher can also capture parameters from the URL and pass them to the view. The view processes the request, interacts with models to fetch or save data, and returns an HttpResponse. This response travels back through the middleware stack (in reverse order) before being sent to the client. Understanding this cycle helps you place logic in the right layer — middleware for cross-cutting concerns, views for business logic, and templates for presentation.

Example

# Visualising the Django request-response cycle

# 1. Browser sends: GET /blog/posts/5/

# 2. Middleware stack (request phase)
#    SecurityMiddleware -> SessionMiddleware -> AuthenticationMiddleware -> ...

# 3. URLconf matching (mysite/urls.py -> blog/urls.py)
from django.urls import path, include

urlpatterns = [
    path('blog/', include('blog.urls')),
]

# blog/urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('posts/<int:pk>/', views.post_detail, name='post-detail'),
]

# 4. View called with request + captured pk=5
# blog/views.py
from django.shortcuts import get_object_or_404, render
from .models import Post

def post_detail(request, pk):
    post = get_object_or_404(Post, pk=pk)
    return render(request, 'blog/post_detail.html', {'post': post})

# 5. Template rendered -> HttpResponse built
# 6. Middleware stack (response phase)
# 7. Response sent to browser

HTML

Full Editor

Related Resources

Django Reference

Complete tag & property list

Django How-To Guides

Step-by-step practical guides

Django Exercises

Practice what you've learned