
在 django rest framework 中,updatemodelmixin 默认不调用自定义 manager 的 update() 方法,因其底层通过 serializer.save() 触发实例级 update(即 model_instance.save()),而非 queryset.update();需重写 perform_update 并显式调用 manager.update(),同时注意传入主键与数据结构。
Django 模型管理器(Manager)的 create() 和 update() 方法作用对象不同:
- create() 是实例创建方法,被 CreateModelMixin 间接调用(经 serializer.save() → Model.objects.create());
- update() 是QuerySet 级批量更新方法,不会触发模型 save() 流程、不调用信号、不执行模型验证、也不实例化对象——因此 UpdateModelMixin 默认完全绕过它。
你遇到的问题根源在于:UpdateModelMixin.perform_update() 默认执行的是 serializer.save(),而该调用最终会走到 instance.save()(即单实例保存),而非 Model.objects.update(...)。即使你自定义了 HelloManager.update(),它也不会被自动调用。
✅ 正确做法是:在 perform_update 中显式调用 Model.objects.update(),并确保传入过滤条件(如 pk=instance.pk)和待更新字段。但注意:QuerySet.update() 返回受影响行数(int),不返回更新后的模型实例,因此直接替换会导致响应返回旧数据(正如你观察到的)。
以下是推荐的完整解决方案:
# views.py
class HelloDetailView(
mixins.RetrieveModelMixin,
mixins.UpdateModelMixin,
generics.GenericAPIView
):
queryset = HelloModel.objects.all()
lookup_field = 'id'
def get_serializer_class(self):
if self.request.method in ['PUT', 'PATCH']:
return HelloWriteSerializer
return HelloReadSerializer
def retrieve(self, request, *args, **kwargs):
return super().retrieve(request, *args, **kwargs)
def update(self, request, *args, **kwargs):
# 关键:先调用父类 update 获取响应,再确保返回最新数据
response = super().update(request, *args, **kwargs)
# 可选:强制刷新实例(若需确保返回值含最新 last_modified)
# (但通常 serializer.save() 后 instance 已刷新,此步非必需)
return response
def perform_update(self, serializer):
instance = serializer.instance
# ✅ 正确调用 manager.update():必须指定过滤条件 + 字段
# 注意:validated_data 是 dict,需解包;且不能包含只读字段(如 pk、date_created)
update_fields = {
k: v for k, v in serializer.validated_data.items()
if k not in ['id', 'pk', 'date_created'] # 排除不可更新字段
}
update_fields['last_modified'] = timezone.now() # 显式设置时间戳
# 执行 QuerySet.update —— 此时 HelloManager.update() 将被调用
HelloModel.objects.filter(pk=instance.pk).update(**update_fields)
# ⚠️ 重要:手动刷新 instance,确保序列化器返回最新状态
# 因为 QuerySet.update() 不修改内存中的 instance 对象
instance.refresh_from_db()? 注意事项:
- Model.objects.update() 是原子 SQL UPDATE,高效但无 ORM 生命周期钩子(如 save()、pre_save/post_save);
- 若业务逻辑依赖 save() 方法(如自定义校验、关联更新、信号触发),应改用重写 instance.save(),并在模型中覆盖 save() 方法:
# models.py def save(self, *args, **kwargs): if self.pk: # update self.last_modified = timezone.now() else: # create now = timezone.now() self.date_created = now self.last_modified = now super().save(*args, **kwargs) - perform_update 中务必调用 instance.refresh_from_db(),否则 serializer.data 仍为更新前状态;
- 使用 timezone.now()(来自 django.utils.timezone)替代 datetime.now(),以保证时区安全。
综上,优先推荐在模型 save() 中统一处理时间戳逻辑,语义清晰、兼容 DRF 默认流程、支持信号与验证;仅当需要高性能批量更新且无需 ORM 钩子时,才显式调用 manager.update() 并配合 refresh_from_db()。










