[Django] Messages Framework: flash 메시지

django messages, flash messages, messages.success, messages.error, add_message

정의

Messages Framework = 1회성 flash 메시지 (성공, 오류 등) 를 사용자에게 표시. Post/Redirect/Get 패턴에서 필수.

목적 + 대안

flowchart LR
    Q{피드백 방법}
    Q -->|"1회성 알림"| Msg["Messages framework"]
    Q -->|"영구 데이터"| Model["Model + View"]
    Q -->|"에러 폼 유지"| Form["Form errors"]
    Q -->|"실시간 push"| WS["WebSocket / SSE"]

기본 설정

# settings.py
INSTALLED_APPS = [
    ...
    'django.contrib.messages',
    ...
]

MIDDLEWARE = [
    'django.contrib.sessions.middleware.SessionMiddleware',
    ...
    'django.contrib.messages.middleware.MessageMiddleware',
]

TEMPLATES = [{
    'OPTIONS': {
        'context_processors': [
            ...
            'django.contrib.messages.context_processors.messages',
        ],
    },
}]

사용

# views.py
from django.contrib import messages

def create_article(request):
    if request.method == 'POST':
        form = ArticleForm(request.POST)
        if form.is_valid():
            form.save()
            messages.success(request, '게시글이 등록되었어요.')
            return redirect('article_list')
        else:
            messages.error(request, '입력을 확인해주세요.')
    else:
        form = ArticleForm()
    return render(request, 'form.html', {'form': form})

5가지 레벨

함수	레벨
messages.debug(request, ...)	DEBUG (10)
messages.info(request, ...)	INFO (20)
messages.success(request, ...)	SUCCESS (25)
messages.warning(request, ...)	WARNING (30)
messages.error(request, ...)	ERROR (40)
messages.add_message(request, level, ...)	커스텀

Template 표시

<!-- base.html -->
{% if messages %}
<div class="messages">
  {% for message in messages %}
    <div class="alert alert-{{ message.tags }}" role="alert">
      {{ message }}
      <button type="button" class="close" data-dismiss="alert">&times;</button>
    </div>
  {% endfor %}
</div>
{% endif %}

message.tags = success, error, warning 등 CSS 클래스 그대로.

옵션 (Extra tags)

messages.success(
    request,
    '완료!',
    extra_tags='animate-bounce',
    fail_silently=False,
)

{{ message.tags }}  <!-- "success animate-bounce" -->

Level 설정

# settings.py
from django.contrib.messages import constants as message_constants

MESSAGE_LEVEL = message_constants.WARNING   # 이 레벨 이상만 저장

# 특정 request 만
messages.set_level(request, messages.DEBUG)

Storage Backend

Backend	의미
SessionStorage (기본)	Django session 에 저장
CookieStorage	브라우저 cookie 에 (session-less)
FallbackStorage (기본)	Cookie 우선, 크면 session

MESSAGE_STORAGE = 'django.contrib.messages.storage.cookie.CookieStorage'

HTMX 통합 예시

from django.http import HttpResponse

def htmx_action(request):
    do_something()
    messages.success(request, '완료됨')

    if request.htmx:
        response = HttpResponse('OK')
        response['HX-Trigger'] = json.dumps({'showMessages': True})
        return response
    return redirect('home')

<div hx-get="{% url 'messages' %}" hx-trigger="showMessages from:body"></div>

Class-Based View 통합

from django.contrib.messages.views import SuccessMessageMixin

class ArticleCreateView(SuccessMessageMixin, CreateView):
    model = Article
    fields = ['title', 'body']
    success_message = '게시글 "%(title)s" 이 등록되었습니다.'
    success_url = '/articles/'

PRG (Post/Redirect/Get) 패턴

sequenceDiagram
    autonumber
    User->>View: POST /create/
    View->>DB: 저장
    View->>Messages: success('완료!')
    View-->>User: 302 → /list/
    User->>View: GET /list/
    View->>Messages: 꺼내기
    View-->>User: HTML with flash
    Note over User: 새로고침 시 message 없음 (1회성)

Rails 의 flash 와 정확히 동일한 패턴.

다른 프레임워크

Framework	Flash message
Django	messages.success()
Rails	flash[:notice]
Spring	RedirectAttributes.addFlashAttribute()
Laravel	session()->flash()
Express	connect-flash middleware

흔한 함정

관련 위키

• django-sessions
• django-views
• django-mixins
• django-mvc-model-bindingresult (Spring 의 PRG)