Django类视图无法渲染模板HTML，是否缺失上下文？

我开始使用Django的类视图（Class based views），但编写的代码在类视图模式下无法渲染模板内容，模板里的main_c.main_categories.url、main_c.name数据完全不显示。切换回函数视图（Function based views）刷新页面后，模板内容可正常展示。我了解到可能和模板找不到上下文有关，但不清楚其含义及解决方法。

相关代码 #

views.py #

class MainCategoryDeleteView(DeleteView):
    model = MainCategory
    success_url = reverse_lazy("main_category")
    template_name = 'admin_dashboard/categories/maincategory_confirm_delete.html'


class MainCategoryUpdateView(UpdateView):
    model = MainCategory
    fields = '__all__'
    success_url = reverse_lazy("main_category")
    template_name = 'admin_dashboard/categories/main_category_edit.html'


class MainCategoryCreateView(CreateView):
    model = MainCategory
    fields = '__all__'
    success_url = reverse_lazy("main_category")
    template_name = 'admin_dashboard/categories/main_category.html'

    def get_context_data(self, **kwargs):
        context = super(MainCategoryCreateView, self).get_context_data(**kwargs)
        context['main_categories'] = MainCategory.objects.all()
        print(MainCategory.objects.all())
        return context

urls.py #

path('BaitSouq/MainCategory/', views.MainCategoryCreateView.as_view(), name="main_category"),
path('BaitSouq/MainCategory/<int:pk>/Delete/', views.MainCategoryDeleteView.as_view(), name="main_category_delete"),
path('BaitSouq/MainCategory/<int:pk>/Change/', views.MainCategoryUpdateView.as_view(), name="main_category_update"),

模板代码 #

<div class="col-lg-2 d-none d-lg-flex">
    <div class="categories-dropdown-wrap style-2 mt-30">
        <div class="d-flex categori-dropdown-inner" style="font-size: x-small">
            <ul>
                {% for main_c in main_categories %}
                    <li>
                        <a href="#"> <img
                                src="{{ main_c.main_categories.url }}"
                                alt=""/>{{ main_c.name }}</a>
                    </li>
                {% endfor %}

            </ul>
        </div>
    </div>
</div>

问题原因 #

1. 上下文变量缺失：你仅在MainCategoryCreateView中重写get_context_data方法注入了main_categories上下文，但MainCategoryUpdateView、MainCategoryDeleteView等其他类视图并没有传递这个变量。当访问更新或删除页面时，模板找不到main_categories，循环内容自然无法渲染。
2. 字段名可能错误：模板中的main_c.main_categories.url大概率存在问题，main_categories更像是模型的关联集合名称，而非单个分类的图片字段。如果你的MainCategory模型里的图片字段是类似image这样的名称，这里的引用就会出错，导致图片无法显示。

解决方法 #

1. 统一注入上下文（推荐） #

创建一个基础视图类，所有需要main_categories的视图都继承它，避免重复编写代码：

from django.views.generic import View

class BaseCategoryView(View):
    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context['main_categories'] = MainCategory.objects.all()
        return context

然后修改现有视图类，让它们继承这个基础类：

class MainCategoryDeleteView(BaseCategoryView, DeleteView):
    model = MainCategory
    success_url = reverse_lazy("main_category")
    template_name = 'admin_dashboard/categories/maincategory_confirm_delete.html'

class MainCategoryUpdateView(BaseCategoryView, UpdateView):
    model = MainCategory
    fields = '__all__'
    success_url = reverse_lazy("main_category")
    template_name = 'admin_dashboard/categories/main_category_edit.html'

class MainCategoryCreateView(BaseCategoryView, CreateView):
    model = MainCategory
    fields = '__all__'
    success_url = reverse_lazy("main_category")
    template_name = 'admin_dashboard/categories/main_category.html'

这样所有继承BaseCategoryView的视图都会自动传递main_categories上下文到模板。

2. 修正模板字段引用 #

打开MainCategory模型文件，确认图片字段的名称。比如模型定义如下：

class MainCategory(models.Model):
    name = models.CharField(max_length=100)
    image = models.ImageField(upload_to='categories/')

那模板中的图片引用要改成：

src="{{ main_c.image.url }}"

3. 调试验证上下文 #

可以在模板中添加调试代码，快速确认main_categories是否存在：

{% if main_categories %}
    <p>共获取到{{ main_categories|length }}个分类</p>
{% else %}
    <p>未获取到分类数据</p>
{% endif %}

通过这段代码可以判断是上下文没传递，还是数据库中没有数据。

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