如何向ModelViewSet发送无URL主键的PUT请求更新用户资料

问题本质是DRF默认路由器对ModelViewSet的路由约定导致的：

• 无主键的基路径/profile/默认仅绑定两个动作：GET 对应列表查询、POST 对应资源创建
• 带主键的路径/profile/<pk>/才会绑定单资源操作：单条查询、PUT/PATCH更新、删除

这种设计的前提是单资源必须靠路径主键定位，但你的场景完全不需要——当前用户的个人资料可以直接从请求上下文拿到，根本不需要传主键。

方案1（最推荐，代码最简，无冗余接口） #

这个场景根本不需要用到全功能ModelViewSet的能力——你不需要支持批量列表查询、不需要新建独立资料、不需要删除资料，只需要对当前用户的唯一资料做获取、更新操作。直接用通用视图混合类实现即可，完全绕开默认路由的绑定规则：

from rest_framework import generics, mixins, permissions
from django.http import Http404

class ProfileRetrieveUpdate(
    mixins.RetrieveModelMixin,
    mixins.UpdateModelMixin,
    generics.GenericAPIView
):
    serializer_class = UserProfileSerializer
    permission_classes = [permissions.IsAuthenticated]

    # 重写对象获取逻辑，直接定位当前登录用户的资料，不需要从URL取主键
    def get_object(self):
        # 加实例缓存，避免单次请求内重复查库
        if not hasattr(self, '_user_profile'):
            try:
                self._user_profile = UserProfile.objects.get(user=self.request.user)
            except UserProfile.DoesNotExist:
                raise Http404("当前用户暂无关联的个人资料")
        return self._user_profile

    # 显式绑定HTTP方法到对应业务动作
    def get(self, request, *args, **kwargs):
        return self.retrieve(request, *args, **kwargs)

    def put(self, request, *args, **kwargs):
        return self.update(request, *args, **kwargs)

    def patch(self, request, *args, **kwargs):
        return self.partial_update(request, *args, **kwargs)

路由直接绑定到无主键的路径即可，不会生成任何冗余的带主键接口：

# 项目urls.py配置
from django.urls import path
from .views import ProfileRetrieveUpdate

urlpatterns = [
    path('profile/', ProfileRetrieveUpdate.as_view(), name='current-user-profile')
]

最终效果就是/profile/路径直接支持GET（查资料）、PUT（全量更新）、PATCH（局部更新），完全符合需求，也没有多余的接口暴露。

方案2（保留现有ModelViewSet结构的实现） #

如果你不想改动现有视图的继承逻辑，想继续用ModelViewSet的结构，那就放弃默认路由器的自动路由生成，手动绑定动作到无主键路径：

1. 先在视图里禁用所有冗余动作，避免多余接口暴露：

   from rest_framework import viewsets, permissions
   from django.http import Http404
   
   class ProfileRetrieveUpdate(viewsets.ModelViewSet):
       serializer_class = UserProfileSerializer
       permission_classes = [permissions.IsAuthenticatedOrReadOnly]
       # 仅保留需要的HTTP方法，禁用用不到的动作
       http_method_names = ['get', 'put', 'patch']
   
       # 把默认冗余的动作直接标记为不存在，避免被路由误绑定
       def list(self, request, *args, **kwargs):
           raise Http404
       def create(self, request, *args, **kwargs):
           raise Http404
       def destroy(self, request, *args, **kwargs):
           raise Http404
   
       # 重写对象获取逻辑，不依赖URL传入的主键
       def get_object(self):
           if not hasattr(self, '_user_profile'):
               try:
                   self._user_profile = UserProfile.objects.get(user=self.request.user)
               except UserProfile.DoesNotExist:
                   raise Http404
           return self._user_profile
   
       def perform_update(self, serializer):
           serializer.save(user=self.request.user)
   

2. 放弃DefaultRouter自动生成路由的逻辑，手动绑定动作到无主键路径：

   from django.urls import path
   from .views import ProfileRetrieveUpdate
   
   # 直接绑定单资源操作到无主键的基路径
   profile_endpoint = ProfileRetrieveUpdate.as_view({
       'get': 'retrieve',
       'put': 'update',
       'patch': 'partial_update'
   })
   
   urlpatterns = [
       path('profile/', profile_endpoint, name='current-user-profile')
   ]
   

注意：这种写法下你原来重写的get_queryset方法基本失去作用，因为get_object已经直接定位到当前用户的资料，完全不需要走默认的主键过滤流程，可以根据实际需求删掉冗余代码。

常见踩坑提醒 #

• 不要试图给ModelViewSet加自定义@action装饰器实现无主键更新，这种方式会自动生成额外的嵌套路径（比如/profile/update/），无法直接绑定到你需要的/profile/根路径，反而增加不必要的路由跳转。

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