Django REST Framework中移除M2M关联值的最佳实践是什么？

这两种实现方式都是合规的，没有绝对的最优解，具体选择完全取决于你的业务场景和接口设计定位：

方案1：PATCH方法 + 序列化器update + ORM set() 全量重置 #

适用场景 #

• 接口遵循标准REST资源设计规范，把M2M关联视为主资源的属性来更新
• 前端提交的是当前关联对象的完整ID列表，不需要单独区分新增/移除的项
• 关联对象数量不大，全量传参不会导致请求体积过大
• 没有高频并发修改同一份关联关系的业务场景

优势 #

• 实现成本最低：不需要自定义任何视图逻辑，只需要在序列化器中把M2M字段声明为可写字段，DRF默认的update逻辑会自动调用set()方法完成全量覆盖
• 逻辑更简单：不需要额外处理参数校验、权限校验的逻辑，复用主资源的现有校验规则即可

注意事项 #

• set()方法接收的参数是完整的关联对象/ID的可迭代对象，不需要额外拆包，正确写法是 obj.m2m.set(list_values)，你写的obj.m2m.set(*[list_values])是错误用法，会导致参数异常
• 全量覆盖会天然存在并发更新冲突问题：如果两个请求同时修改同一份关联关系，后提交的请求会覆盖前一个请求的修改

方案2：自定义DELETE动作 + ORM remove() 定向移除 #

适用场景 #

• 接口需要支持单独移除部分关联对象，前端不需要传递完整的关联列表，适合关联对象数量很大的场景，大幅减少请求体积
• 存在高频并发修改同一份关联关系的场景，需要避免全量覆盖导致的更新丢失问题
• 业务上需要记录关联对象的移除操作日志，单独的移除接口更容易做埋点和审计

实现方式 #

用DRF的@action装饰器在主资源视图上自定义一个DELETE类型的动作即可，示例代码：

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

class YourModelViewSet(viewsets.ModelViewSet):
    queryset = YourModel.objects.all()
    serializer_class = YourModelSerializer

    @action(detail=True, methods=['delete'], url_path='remove-m2m-items')
    def remove_m2m_items(self, request, pk=None):
        obj = self.get_object()
        # 校验要移除的ID列表参数
        to_remove_ids = request.data.get('to_remove_ids', [])
        # 这里可以加参数合法性校验，比如校验ID是否存在、是否有权限移除等
        obj.m2m_field.remove(*to_remove_ids)
        return Response(status=204)

注意事项 #

• remove()方法支持传入多个位置参数，所以需要把ID列表拆包传入，obj.m2m.remove(*list_of_values)的写法是正确的
• 如果要移除的ID不存在于当前关联关系中，remove()方法不会抛出异常，如果你需要做不存在的校验，需要自己提前判断

总结：如果是标准的REST资源更新场景，优先选方案1，更符合REST规范，实现成本最低；如果有批量移除部分关联、避免并发冲突、操作审计的需求，选方案2更合适。

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