Django函数视图使用request.user过滤查询集后模板无内容问题

排查步骤 #

• 第一步：确认访问视图的用户已完成登录
  request.user如果是未登录的匿名用户，filter(user=request.user)永远不会返回匹配结果。可以先给视图加上登录校验装饰器，避免匿名用户访问：

  from django.contrib.auth.decorators import login_required
  
  @login_required
  def Resume(request):
      experience = Experience.objects.filter(user = request.user)
      return render(request, 'resume.html', {'experience': experience})
  

• 第二步：校验查询是否真的返回了数据
  在视图中加入调试打印，确认当前用户身份和查询结果：

  def Resume(request):
      # 输出当前用户身份信息
      print("当前用户：", request.user, "是否已认证：", request.user.is_authenticated)
      experience = Experience.objects.filter(user = request.user)
      # 输出匹配结果数量和执行的SQL语句，方便排查
      print("匹配数据量：", experience.count())
      print("执行SQL：", experience.query)
      return render(request, 'resume.html', {'experience': experience})
  

  触发请求后查看控制台输出，如果匹配数据量为0，说明确实没有和当前用户关联的Experience数据。
• 第三步：确认现有Experience数据的user字段关联关系
  你模型中的user字段设置了null=True，大概率是之前创建Experience数据时没有给user字段赋值，导致存量数据的user字段都是空值，all()可以查到这些空值数据，但filter(user=request.user)匹配不到。你可以进入Django shell执行查询验证：

  # 替换为你登录的用户名
  user = User.objects.get(username="你的登录用户名")
  # 查看该用户关联的经历数量
  print(Experience.objects.filter(user=user).count())
  # 查看所有user字段为空的经历数量
  print(Experience.objects.filter(user__isnull=True).count())
  

解决方法 #

1. 补充新增经历时的user字段赋值逻辑
   在创建Experience的视图中，保存实例前必须关联当前登录用户，示例如下（以ModelForm为例）：

def create_experience(request):
    if request.method == "POST":
        form = ExperienceForm(request.POST)
        if form.is_valid():
            exp = form.save(commit=False)
            exp.user = request.user # 必须加这行关联当前用户
            exp.save()
            return redirect("resume")
    # 其余视图逻辑

2. 批量补全存量历史数据的user关联
   如果需要把之前创建的无主经历分配给指定用户，可以在Django shell中执行批量更新：

# 替换为目标用户名
target_user = User.objects.get(username="目标用户名")
Experience.objects.filter(user__isnull=True).update(user=target_user)

3. 模板补充空状态提示
   可以在模板中增加无数据时的提示，避免空白页面无法定位问题：

{% if experience %}
<ul>
    {% for an_experience in experience %}
    <a href="{% url 'edit_experience' an_experience.pk %}"><li ><h5>{{ an_experience }},</h5></a> {{ an_experience.company_address }} - {{ an_experience.post_held }}</li>
    <small>{{ an_experience.year_from }} - {{ an_experience.year_to }}</small>
    <div>
        {{ an_experience.info }}
    </div>
    {% endfor %}
</ul>
{% else %}
<p>暂无你的工作经历数据</p>
{% endif %}

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