在Django Rest Framework中实现按条件批量删除对象的最优方案

针对你需要批量删除指定品牌产品的场景，推荐以下符合REST规范且兼容requests库的最佳实践：

方案1：在ModelViewSet中自定义批量删除Action（优先推荐） #

直接在已有的ProductViewSet中扩展自定义动作，复用DRF的路由系统，避免新增独立端点，同时用DELETE方法保证语义正确，通过查询参数传递过滤条件（规避requests不支持DELETE带请求体的问题）。

代码实现（views.py） #

from rest_framework import viewsets, status
from rest_framework.decorators import action
from rest_framework.response import Response
from rest_framework.permissions import IsAdminUser
from .models import Product
from .serializers import ProductSerializer

class ProductViewSet(viewsets.ModelViewSet):
    queryset = Product.objects.all()
    serializer_class = ProductSerializer
    permission_classes = [IsAdminUser]

    @action(detail=False, methods=['delete'], url_path='by-brand')
    def delete_by_brand(self, request):
        # 从查询参数中获取要删除的品牌
        target_brand = request.query_params.get('brand')
        
        if not target_brand:
            return Response(
                {'error': '必须提供brand参数'},
                status=status.HTTP_400_BAD_REQUEST
            )
        
        # 执行批量删除，返回删除的数量
        deleted_count, _ = self.queryset.filter(brand=target_brand).delete()
        
        return Response(
            {'result': f'成功删除{deleted_count}个品牌为{target_brand}的产品'},
            status=status.HTTP_200_OK
        )

路由配置（urls.py） #

无需新增独立路径，DRF的DefaultRouter会自动生成对应的端点：

from products.api import views as bv
from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register(r"products", bv.ProductViewSet)

urlpatterns = [
    path("", include(router.urls)),
]

生成的批量删除端点为：/products/by-brand/

用requests发送请求的示例 #

import requests

# 替换为你的API地址和认证信息
api_url = "http://your-domain.com/products/by-brand/"
auth_headers = {"Authorization": "Bearer your-admin-token"}

response = requests.delete(
    api_url,
    params={"brand": "X"},  # 通过查询参数传递品牌条件
    headers=auth_headers
)

print(response.json())

方案2：复杂条件下的批量删除（备选） #

如果需要基于多个复杂条件批量删除（比如同时过滤品牌、价格区间等），可以在ProductViewSet中新增一个接收POST请求的批量删除Action，但要明确语义：

@action(detail=False, methods=['post'], url_path='batch-delete')
def batch_delete(self, request):
    filters = request.data
    if not filters:
        return Response(
            {'error': '必须提供过滤条件'},
            status=status.HTTP_400_BAD_REQUEST
        )
    
    deleted_count, _ = self.queryset.filter(**filters).delete()
    return Response(
        {'result': f'成功删除{deleted_count}个产品'},
        status=status.HTTP_200_OK
    )

此时发送POST请求，请求体携带过滤条件即可，这种方式适合复杂场景，但语义上不如DELETE纯粹，仅作为备选。

为什么你的当前方案不够理想 #

• 语义不符：POST请求的标准语义是创建资源，用它执行删除操作违反REST规范，会增加接口的理解成本。
• 路由分散：新增独立端点会打破ViewSet的路由统一管理，增加后续维护复杂度。

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