本文旨在解决在使用 django REST Framework (DRF) 时，如何通过 PATCH 请求仅更新模型的特定字段，避免因序列化器验证导致的必填字段缺失错误。我们将深入探讨 update 方法的正确使用姿势，并提供修改后的代码示例，确保仅更新所需字段。
在使用 Django REST Framework (DRF) 进行 API 开发时，经常需要实现对模型的部分更新。通常情况下，我们会使用 PATCH 请求来实现这一功能。然而，当模型的序列化器中存在必填字段时，即使我们只想更新部分字段，DRF 仍然会要求提供所有必填字段的值，这会导致不必要的麻烦。本文将详细介绍如何正确处理这种情况，确保通过 PATCH 请求仅更新指定的字段。
理解 DRF 的 update 方法和 partial_update 方法
DRF 的 ModelViewSet 提供了默认的 update 和 partial_update 方法用于更新模型实例。当接收到 PUT 请求时，DRF 会调用 update 方法，该方法期望接收完整的模型数据。而当接收到 PATCH 请求时，DRF 会调用 partial_update 方法，该方法允许只更新部分字段。
关键在于 partial_update 方法会将 partial=True 传递给 update 方法，然后在 update 方法中，这个 partial 参数会被传递给序列化器。序列化器在验证数据时，会根据 partial 参数的值来决定是否需要验证所有字段。
解决 username 必填错误
根据提供的代码，问题出现在 CustomUserViewSet 的 update 方法中。尽管使用了 PATCH 请求，但 update 方法并没有正确地处理 partial 参数，导致序列化器仍然要求提供 username 字段。
要解决这个问题，需要修改 update 方法，使其能够正确地接收和使用 partial 参数。以下是修改后的代码：
class CustomUserViewSet(viewsets.ModelViewSet): serializer_class = s.CustomUserSerializer queryset = m.CustomUser.objects.all() def update(self, request, *args, **kwargs): partial = kwargs.pop('partial', False) print("custom user update") print(request.data) # <QueryDict: {'detail': ['{"fileObj":19}']}> instance = self.get_object() serializer = self.get_serializer(instance, data=request.data, partial=partial) if serializer.is_valid(): self.perform_update(serializer) return Response(serializer.data) else: print(serializer.errors) # check error. return Response(serializer.errors, status=400) # 建议返回错误状态码
在这个修改后的 update 方法中，我们首先使用 kwargs.pop(‘partial’, False) 获取 partial 参数的值，并将其传递给 serializer。这样，当接收到 PATCH 请求时，序列化器就会知道这是一个部分更新，从而不会强制要求提供所有必填字段的值。
前端代码注意事项
确保前端代码发送的是 PATCH 请求，并且 Content-Type 设置为 multipart/form-data 或者 application/json。
如果使用 multipart/form-data，需要注意数据类型的转换。例如，JSON 数据需要使用 JSON.stringify() 进行序列化，然后再添加到 FormData 中。
var formData = new FormData(); var status = { fileObj:this.fileObj.id } console.log("syncdata to user table",status); console.log("syncdata for user:",request); formData.append("detail",JSON.stringify(status)); axios.patch( `/api/customusers/3/`,formData,{ headers: { 'Content-Type': 'multipart/form-data' } } ).then(function (response) { console.log("syncdata customuser is saved:",response); }) .catch(function (response) { console.log("syncdata customuser failed:",response); });
或者使用 application/json：
import axios from 'axios'; const status = { fileObj: this.fileObj.id }; axios.patch( `/api/customusers/3/`, { detail: status }, // 直接发送 JSON 对象 { headers: { 'Content-Type': 'application/json' } } ) .then(response => { console.log("syncdata customuser is saved:", response); }) .catch(error => { console.error("syncdata customuser failed:", error); });
总结
通过正确地处理 partial 参数，我们可以轻松地实现对模型的特定字段的更新，而无需提供所有必填字段的值。这不仅简化了 API 的使用，也提高了开发效率。在实际开发中，需要根据具体的需求选择合适的数据格式和请求方式，并确保前端和后端代码能够正确地配合工作。同时，建议在 update 方法中添加错误处理，返回适当的错误状态码，以便前端能够更好地处理错误情况。
