Django模板无需修改views.py获取模型数据的问题排查

常见错误原因及修复方案 #

1. 模板标签返回了字符串而非QuerySet实例 #

如果你的标签函数里不小心把QuerySet转成了字符串（比如用str(Notifications.objects.all())），模板就会直接输出QuerySet [...]的文本，循环自然无法遍历。

修复：确保标签直接返回QuerySet对象，比如针对当前用户过滤通知：

from django import template
from .models import Notifications

register = template.Library()

@register.simple_tag(takes_context=True)
def get_user_notifications(context):
    user = context['request'].user
    return Notifications.objects.filter(recipient=user) if user.is_authenticated else Notifications.objects.none()

2. 标签注册未正确传递上下文 #

要获取当前用户的通知，必须让标签能访问request对象。如果没加takes_context=True，标签拿不到用户信息，要么返回所有通知（可能不是你想要的），要么过滤错误导致空QuerySet。

修复：在@register.simple_tag后加上takes_context=True，通过context['request']获取用户。

3. 模板调用时未赋值给变量 #

直接写{% get_user_notifications %}会让标签返回的QuerySet直接被转换成字符串输出，而不是存储为变量供循环使用。

正确调用方式：

{% get_user_notifications as notifications %}
{% for notification in notifications %}
    <div>
        <h5>{{ notification.title }}</h5>
        <p>{{ notification.message }}</p>
    </div>
{% empty %}
    <p>暂无通知</p>
{% endfor %}

4. 模型关联或过滤条件错误 #

如果Notifications模型没有正确关联用户（比如外键字段名不是recipient），或者过滤条件写错，会导致返回空QuerySet，循环无内容。

检查模型定义：

from django.db import models
from django.contrib.auth.models import User

class Notifications(models.Model):
    title = models.CharField(max_length=200)
    message = models.TextField()
    recipient = models.ForeignKey(User, on_delete=models.CASCADE)
    # 其他字段...

5. 未加载模板标签库 #

在base.html的开头必须加载你定义的标签库，否则标签不会生效。假设标签文件是templatetags/notification_tags.py，则：

{% load notification_tags %}

完整实现示例 #

1. 在你的app目录下创建templatetags文件夹，添加__init__.py和notification_tags.py文件。
2. 编写notification_tags.py代码（如上述示例）。
3. 在base.html头部加载标签库，然后按正确方式调用并循环遍历。

内容的提问来源于stack exchange，提问作者Bob The Builder