消息框架：如何去除模板渲染中的重复消息？

嘿，遇到消息重复显示的问题挺常见的，我来给你梳理几个排查和解决的方向：

• 检查视图中的消息添加逻辑
  最常见的原因就是不小心在循环里多次添加了同一条消息。比如你在遍历数据的时候，把messages.success()这类方法写在了循环内部，每循环一次就加一遍消息，自然会重复输出。
  举个错误示例：

  for item in my_items:
      messages.info(request, "数据处理完成")  # 循环几次就加几条相同消息
  

  改成把消息放在循环外面就好：

  if my_items:
      messages.info(request, "数据处理完成")  # 只添加一次
  

  另外也要检查是不是同一个请求里的多个逻辑分支都触发了添加同一条消息的代码，比如if和else块里都加了同样的提示，这种情况也会导致重复。

• 排查模板的重复渲染
  看看你的模板结构，是不是父模板已经写了消息渲染的循环，子模板又重复写了一遍？或者某个包含消息渲染的模板被{% include %}了多次，导致消息被渲染多轮。
  比如你的base.html里已经有这段消息渲染代码，然后你在home.html里又复制了一遍，那页面上就会显示两次相同的消息。

• 临时去重兜底方案
  如果前面的排查都没找到问题，或者需要快速临时解决，可以在模板或视图里做去重处理：

  • 模板层面：可以借助模板标签实现基于消息内容的去重：

    {% with seen_messages=set %}
        {% for message in messages %}
            {% if message.message not in seen_messages %}
                <div class="{{ message.tags }}">{{ message }}</div>
                {% seen_messages.add(message.message) %}
            {% endif %}
        {% endfor %}
    {% endwith %}
    

  • 视图层面：提前获取消息列表并去重后传给模板：

    from django.contrib.messages import get_messages
    
    def your_view(request):
        # 先获取所有消息
        all_messages = list(get_messages(request))
        # 基于消息内容去重
        unique_messages = []
        seen_content = set()
        for msg in all_messages:
            if msg.message not in seen_content:
                seen_content.add(msg.message)
                unique_messages.append(msg)
        # 把去重后的消息传给模板
        return render(request, 'your_template.html', {'messages': unique_messages})
    

• 检查消息存储配置
  这个情况比较少见，但也可以排查下settings.py里的MESSAGE_STORAGE配置，确保没有配置多个存储后端导致消息被多次存储。默认的django.contrib.messages.storage.session.SessionStorage或者CookieStorage都是正常的，一般不会出问题。

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