Django中UpdateView的CommentForm无法预填充问题求助

问题背景 #

在Django项目中，基于UpdateView实现的CommentUpdate类可正常处理评论更新逻辑，但复用PostDetail模板通过模态框展示更新表单时，表单无法加载评论原有内容（预填充失败）。单独使用独立模板时预填充功能正常，排查发现PostDetail模板中同时存在两个表单渲染标签，分别对应评论创建和更新操作。

根本原因 #

1. PostDetail视图向模板传递的comment_form是空的CommentForm实例，用于评论创建。
2. CommentUpdate作为UpdateView子类，默认将预填充的表单实例以form变量名传入模板，但模板中更新表单使用的是{{ comment_form | crispy }}，因此实际渲染的是PostDetail传入的空表单，而非更新所需的预填充表单。

解决方案 #

以下两种方式任选其一即可：

方式一：区分创建与更新表单的变量名 #

1. 修改PostDetail视图的表单变量名

将创建评论的表单变量名改为create_comment_form，避免和更新表单冲突：

# views.py
class PostDetail(View):
    def get(self, request, slug, pk, *args, **kwargs):
        queryset = Post.objects.all()
        post = get_object_or_404(queryset, slug=slug, pk=pk)
        comments = post.comments.order_by('-created_on')

        return render(
            request,
            'blog/post_detail.html',
            {
                'post': post,
                'comments': comments,
                'create_comment_form': CommentForm()  # 修改变量名
            },
        )

    def post(self, request, slug, pk, *args, **kwargs):
        if request.user.is_authenticated:
            queryset = Post.objects.all()
            post = get_object_or_404(queryset, slug=slug, pk=pk)
            create_comment_form = CommentForm(data=request.POST)  # 修改变量名

            if create_comment_form.is_valid():
                comment = create_comment_form.save(commit=False)
                comment.post = post
                comment.author = request.user
                comment.save()
                messages.info(request, 'Comment added')

        return HttpResponseRedirect(reverse('post_detail', args=[slug, pk]))

2. 修改CommentUpdate视图的上下文传递

重写get_context_data方法，将预填充表单以comment_form变量名传入，并补充模板所需的其他变量：

# views.py
class CommentUpdate(LoginRequiredMixin, UserPassesTestMixin, generic.UpdateView):
    model = Comment
    template_name = 'blog/post_detail.html'
    form_class = CommentForm
 
    def get_success_url(self):
        post = Post.objects.get(pk=self.object.post.pk)
        messages.info(self.request, 'Comment updated')
        return post.get_absolute_url()

    def form_valid(self, form):
        form.instance.author = self.request.user
        return super().form_valid(form)

    def test_func(self):
        comment = self.get_object()
        return self.request.user == comment.author

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        # 将UpdateView默认的form变量赋值给comment_form
        context['comment_form'] = context['form']
        # 补充模板所需的post和comments变量
        post = self.object.post
        context['post'] = post
        context['comments'] = post.comments.order_by('-created_on')
        return context

3. 更新模板中的表单渲染标签

修改创建评论的表单代码，使用新的变量名：

<!-- 评论创建表单 -->
<form action="{% url 'post_detail' post.slug post.pk %}" method="POST">
  {% csrf_token %}
  {{ create_comment_form | crispy }}                          
  <button type="submit" class="btn">Add Comment</button>
</form>

更新评论的表单代码保持不变：

<!-- 评论更新表单 -->
<form action="{% url 'comment_update' post.slug comment.pk %}" method="POST">
  {% csrf_token %}
  {{ comment_form | crispy }}                          
  <button type="submit" class="btn">Update</button>
</form>

方式二：使用UpdateView默认表单变量名 #

1. 修改模板中的更新表单标签

直接使用UpdateView默认传入的form变量渲染更新表单：

<!-- 评论更新表单 -->
<form action="{% url 'comment_update' post.slug comment.pk %}" method="POST">
  {% csrf_token %}
  {{ form | crispy }}  <!-- 改用form变量 -->                        
  <button type="submit" class="btn">Update</button>
</form>

2. 补充CommentUpdate视图的上下文变量

重写get_context_data方法，传入模板所需的post、comments和创建表单的空实例：

# views.py
class CommentUpdate(LoginRequiredMixin, UserPassesTestMixin, generic.UpdateView):
    model = Comment
    template_name = 'blog/post_detail.html'
    form_class = CommentForm
 
    def get_success_url(self):
        post = Post.objects.get(pk=self.object.post.pk)
        messages.info(self.request, 'Comment updated')
        return post.get_absolute_url()

    def form_valid(self, form):
        form.instance.author = self.request.user
        return super().form_valid(form)

    def test_func(self):
        comment = self.get_object()
        return self.request.user == comment.author

    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        post = self.object.post
        context['post'] = post
        context['comments'] = post.comments.order_by('-created_on')
        # 传入创建评论的空表单，避免模板报错
        context['comment_form'] = CommentForm()
        return context

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