Django REST Framework嵌套对象分页问题求助（Django2.0.4+DRF3.7.7）

我完全理解你现在遇到的困扰——嵌套在Place详情里的照片分页链接错误指向了Place列表的API地址，而不是对应单个Place照片的专属分页路径。这是因为你直接复用了Place API的request对象，DRF分页器默认会基于当前request的路径生成链接，自然就跑偏了。

问题根源分析 #

当前你在PlaceSerializer的get_photos方法里直接对照片进行分页，但DRF的分页器是依赖传入的request对象来构建next/previous链接的。这个request来自Place的详情请求（比如/api/v1/places/1/），所以分页器生成的链接会是/api/v1/places/?page=2，而不是我们需要的/api/v1/places/1/photos/?page=2。

解决方案推荐 #

方案1：为照片创建独立的API端点（RESTful最佳实践）

这种方式更符合REST设计规范，也能彻底解决分页链接的问题，同时让代码结构更清晰。

1. 创建PlacePhoto的ViewSet

from rest_framework import viewsets
from .models import PlacePhoto
from .serializers import PlacePhotoSerializer
from .pagination import RelationPaginator

class PlacePhotoViewSet(viewsets.ReadOnlyModelViewSet):
    serializer_class = PlacePhotoSerializer
    pagination_class = RelationPaginator

    def get_queryset(self):
        # 过滤出当前Place对应的所有照片
        return PlacePhoto.objects.filter(place_id=self.kwargs['place_pk'])

2. 配置嵌套路由
   在urls.py里注册嵌套路由，让每个Place都有自己的照片分页接口：

from django.urls import path, include
from rest_framework.routers import DefaultRouter
from .views import PlaceViewSet, PlacePhotoViewSet

router = DefaultRouter()
router.register(r'places', PlaceViewSet)
# 注册嵌套路由，对应单个Place的照片列表
router.register(
    r'places/(?P<place_pk>[^/.]+)/photos', 
    PlacePhotoViewSet, 
    basename='place-photos'
)

urlpatterns = [
    path('api/v1/', include(router.urls)),
]

3. 修改PlaceSerializer，返回照片接口链接
   不再在Place详情里嵌套分页数据，而是给前端提供照片接口的入口链接：

class PlaceSerializer(serializers.ModelSerializer):
    photos_url = serializers.HyperlinkedIdentityField(
        view_name='place-photos-list',
        lookup_url_kwarg='place_pk'
    )

    class Meta:
        model = Place
        fields = ('id', 'name', 'photos_url', )

这样前端拿到photos_url后，就可以单独请求该地址获取分页的照片，分页链接会自动变成正确的/api/v1/places/1/photos/?page=2。

方案2：强制修改分页器的基础链接（嵌套分页需求）

如果你一定要在Place详情接口里直接返回第一页的照片分页数据，可以通过自定义分页器来手动指定基础链接：

1. 修改RelationPaginator
   让分页器支持传入自定义的基础URL：

class RelationPaginator(pagination.PageNumberPagination):
    def __init__(self, base_url=None):
        super().__init__()
        self.base_url = base_url

    def get_paginated_response(self, data):
        # 用自定义base_url构建分页链接
        if self.base_url:
            next_link = f"{self.base_url}?page={self.next_page_number()}" if self.has_next() else None
            prev_link = f"{self.base_url}?page={self.previous_page_number()}" if self.has_previous() else None
        else:
            next_link = self.get_next_link()
            prev_link = self.get_previous_link()

        return {
            'next': next_link,
            'previous': prev_link,
            'count': self.page.paginator.count,
            'results': data
        }

2. 更新PlaceSerializer的get_photos方法
   构建当前Place照片接口的基础URL，传给分页器：

def get_photos(self, obj):
    photos = obj.photos.all()
    request = self.context.get('request')
    serializer = PlacePhotoSerializer(photos, many=True, context={'request': request})
    
    # 构建当前Place照片接口的绝对路径
    base_url = request.build_absolute_uri(f"/api/v1/places/{obj.id}/photos/")
    paginator = RelationPaginator(base_url=base_url)
    
    # 注意：这里依然需要方案1中的PlacePhotoViewSet来支持分页链接的请求
    paginated_data = paginator.paginate_queryset(serializer.data, request)
    return paginator.get_paginated_response(paginated_data)

⚠️ 注意：这种方式只是修正了链接显示，但前端点击next链接时，依然需要方案1中的PlacePhotoViewSet提供后端支持，否则会返回404。

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