Django Messages调试标签消息无法在模板显示问题求助

核心原因1：默认消息级别过滤了DEBUG消息 #

Django Messages框架默认的MESSAGE_LEVEL是messages.INFO，DEBUG级别（优先级更低）的消息会被自动过滤，不会被添加到消息队列中。

解决步骤：
在settings.py中添加一行配置：

from django.contrib import messages
MESSAGE_LEVEL = messages.DEBUG

核心原因2：模板未渲染DEBUG级别的消息 #

如果你的模板只针对错误/信息级别做了渲染逻辑，会漏掉DEBUG消息。

检查模板代码：
确保模板中循环所有消息，而非仅过滤特定级别。比如正确的渲染逻辑：

{% if messages %}
  {% for message in messages %}
    <div class="alert alert-{{ message.tags }}">
      {{ message }}
    </div>
  {% endfor %}
{% endif %}

如果需要针对DEBUG级别单独设置样式，可添加判断：

{% if messages %}
  {% for message in messages %}
    <div class="alert {% if message.level == messages.DEBUG %}alert-secondary{% elif message.level == messages.ERROR %}alert-danger{% endif %}">
      {{ message }}
    </div>
  {% endfor %}
{% endif %}

额外排查点 #

• 确认views.py中调用的是messages.debug(request, "调试内容")，而非其他级别方法（如messages.error）。
• 检查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',
              ],
          },
      },
  ]
  
  MESSAGE_STORAGE = 'django.contrib.messages.storage.session.SessionStorage'  # 或CookieStorage
  

内容的提问来源于stack exchange，提问作者Jake Mulhern