Django 4.x 多对多关系下CBV分页条件QuerySet实现问询

免责声明： 发帖前我已完成相关内容检索，未找到解决该特定问题的同类提问。

需求说明 #

我需要在基于类的视图（CBV）中，对通过多对多关系获取的QuerySet实现分页（Pagination）功能，具体需求如下：

• 多条图书馆记录（Library Records）可归属到多个馆藏（Collections）
• 大部分（非全部）馆藏需要配置对应展示网页，因此我需要根据客户明确提出的需求构建对应的视图、模板与路由
• 每个展示关联图书馆记录的馆藏页面都需要实现分页，因为单页可能需要展示数百条记录。

初步尝试方案 #

基于上述需求，我最初按照常规的带分页功能CBV的开发方式实现，但该方案无法满足需求。我很快发现CBV中的分页方法是基于声明的模型构建对象集，无法适配当前的多对多关系场景。
我尝试过在模板中直接调用对象，但多次尝试后均未取得进展。我需要展示图书馆记录对象，但多对多关系要求我必须先根据记录所属的馆藏筛选出对应记录后再做展示。

补充：相关模型代码 #

models.py

class CollectionOrder(models.Model):
    collection = models.ForeignKey(
        Collection,
        related_name='collection_in_collection_order',
        on_delete=models.PROTECT,
        null=True,
        blank=True,
        verbose_name='Collection'
    )
    record = models.ForeignKey(
        LibraryRecord,
        related_name='record_in_collection_order',
        on_delete=models.PROTECT,
        null=True,
        blank=True,
        verbose_name='Library record',
    )
    order_number = models.PositiveIntegerField(
        blank=True,
        null=True,
    )

请问在该场景下应如何正确实现符合需求的分页功能？

实现方案 #

Django类视图的分页逻辑本身不限制QuerySet来源，只要返回标准QuerySet对象即可正常工作，之前方案失效是因为默认get_queryset拉取了全量模型数据，没有按当前馆藏做关联筛选，按以下方式实现即可：

1. 视图层实现
   直接复用Django自带的ListView，自带完整分页支持，只需重写get_queryset方法返回当前馆藏关联的记录集即可：

from django.views.generic import ListView
from django.shortcuts import get_object_or_404
from .models import Collection, LibraryRecord

class CollectionRecordListView(ListView):
    model = LibraryRecord
    template_name = "collection/record_list.html"
    paginate_by = 30  # 按需调整单页展示条数
    context_object_name = "records"

    def get_queryset(self):
        # 从路由参数获取当前馆藏ID，不存在则直接返回404
        collection_id = self.kwargs.get("collection_id")
        current_collection = get_object_or_404(Collection, id=collection_id)
        # 跨中间表筛选当前馆藏关联的图书馆记录，支持按中间表的order_number字段排序
        return LibraryRecord.objects.filter(
            record_in_collection_order__collection=current_collection
        ).order_by("record_in_collection_order__order_number")

2. 路由配置
   正常配置带馆藏ID参数的路由即可，无需特殊处理：

from django.urls import path
from .views import CollectionRecordListView

urlpatterns = [
    path(
        "collection/<int:collection_id>/records/",
        CollectionRecordListView.as_view(),
        name="collection_record_list"
    ),
]

3. 模板渲染
   分页逻辑和普通ListView完全一致，不需要针对多对多场景做特殊适配：

<!-- 记录列表区域 -->
<div class="record-list">
{% for record in records %}
    <div class="record-item">
        <h3>{{ record.title }}</h3>
        <!-- 按需替换为LibraryRecord模型需要展示的字段 -->
    </div>
{% empty %}
    <p>当前馆藏暂无关联记录</p>
{% endfor %}
</div>

<!-- 分页导航区域 -->
<div class="pagination-nav">
    {% if page_obj.has_previous %}
        <a href="?page=1">首页</a>
        <a href="?page={{ page_obj.previous_page_number }}">上一页</a>
    {% endif %}

    <span class="page-info">
        第{{ page_obj.number }}页 / 共{{ page_obj.paginator.num_pages }}页
    </span>

    {% if page_obj.has_next %}
        <a href="?page={{ page_obj.next_page_number }}">下一页</a>
        <a href="?page={{ page_obj.paginator.num_pages }}">尾页</a>
    {% endif %}
</div>

注意事项 #

• 因为使用自建中间模型CollectionOrder实现多对多关联，跨表查询使用Django ORM标准双下划线语法即可，返回的依然是LibraryRecord模型的标准QuerySet，分页组件可以直接识别。
• 如果需要支持自定义排序、关键词搜索等扩展功能，直接在get_queryset方法中追加过滤、排序逻辑即可，不会影响分页功能正常运行。

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