Django ViewSet同时使用id与md5作为查询字段报错的解决方案咨询

首先得说，你之前的思路踩了两个坑，才导致那个check() got an unexpected keyword argument 'pk'错误：

• 你在detail_route方法里修改类属性lookup_field，但DRF的ViewSet实例是请求间复用的，这种全局修改会导致后续请求的路由解析彻底混乱；
• detail_route默认生成的路由是/{pk}/test/，它会把URL里的参数传给pk，但你改成lookup_field = 'md5'后，DRF期望接收的参数是md5而非pk，参数不匹配自然报错。

完全不需要拆分ViewSet，给你两种靠谱的解决方案，按需选择：

方案一：同一个详情接口兼容ID和MD5查询 #

如果想让/items/{value}/这个接口同时支持传入ID或MD5值，直接重写get_object方法即可，让它先尝试按ID查找，找不到再按MD5匹配：

from rest_framework.exceptions import NotFound

class ItemViewSet(viewsets.ModelViewSet):
    queryset = Item.objects.all()
    serializer_class = ItemSerializer
    permission_classes = [AllowAny]
    lookup_field = 'id'  # 保持默认的lookup字段为id

    def get_object(self):
        queryset = self.filter_queryset(self.get_queryset())
        value = self.kwargs[self.lookup_url_kwarg or self.lookup_field]
        
        # 先尝试按ID查找
        try:
            return queryset.get(id=value)
        except Item.DoesNotExist:
            # ID找不到，尝试按MD5查找
            try:
                return queryset.get(md5=value)
            except Item.DoesNotExist:
                raise NotFound("指定的Item不存在")

这种方式的好处是路由简洁，但要注意：如果你的MD5值可能是纯数字（和ID格式重叠），可能会出现匹配错误——比如某个MD5刚好是数字，会被优先当成ID查找。

方案二：新增独立的MD5查询路由 #

如果想让路由更清晰，比如用/items/md5/{md5_value}/专门处理MD5查询，保留原有的/items/{id}/用ID查询，可以用DRF的action装饰器来实现：

from rest_framework import status
from rest_framework.decorators import action
from rest_framework.response import Response

class ItemViewSet(viewsets.ModelViewSet):
    queryset = Item.objects.all()
    serializer_class = ItemSerializer
    permission_classes = [AllowAny]
    lookup_field = 'id'

    @action(methods=['GET'], detail=False, url_path='md5/(?P<md5>[^/.]+)')
    def get_by_md5(self, request, md5=None):
        try:
            item = self.queryset.get(md5=md5)
            serializer = self.get_serializer(item)
            return Response(serializer.data)
        except Item.DoesNotExist:
            return Response({"detail": "指定的Item不存在"}, status=status.HTTP_404_NOT_FOUND)

这个方案的优点是路由语义明确，不会有参数格式混淆的问题，后续维护也更清晰。

两种方案都不需要拆分ViewSet，选哪种取决于你对路由风格的需求。

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