DRF默认不支持批量操作，需显式处理many=True或引入额外逻辑；最轻量方案是重写get_serializer()动态启用many=True，适合快速扩展批量创建，但不适用于批量更新/删除。
DRF 默认不支持批量创建、更新或删除，必须显式处理 many=True 或引入额外逻辑，否则会报 TypeError: expected a dictionary, got list 或静默失败。
用 get_serializer() 动态启用 many=True
这是最轻量、无第三方依赖的方案，适合已有 ViewSet 快速扩展批量创建。
- 核心是重写
get_serializer()：当request.data是 list 时，自动传入many=True，否则走默认逻辑 - 必须确保序列化器字段允许空值或提供默认值，否则批量创建单条数据（非 list）时可能校验失败
- 不适用于批量更新/删除，因为 PUT/PATCH/DELETE 的 request.data 语义上不是资源列表，需额外解析 ID 或 payload 结构
- 示例片段：
def get_serializer(self, *args, **kwargs):
serializer_class = self.get_serializer_class()
kwargs.setdefault('context', self.get_serializer_context())
if isinstance(self.request.data, list):
return serializer_class(many=True, *args, **kwargs)
return serializer_class(*args, **kwargs)
用 @action 实现语义清晰的批量接口
适合需要明确控制行为、带参数过滤、或混合操作（如批量启用+记录日志）的场景。
-
@action(methods=['delete'], detail=False)表示该接口作用于集合，URL 路径不带 pk，如/api/users/multi_delete/ - 删除常用 query 参数传 ID 列表：
ids=1,2,3，但注意 URL 长度限制（通常 ≤2000 字符），超长应改用 POST + body - 更新建议用 POST + JSON body，避免 PUT/PATCH 在代理层丢弃 body 的风险（尤其 Nginx、CDN、某些防火墙）
- 别忘了在 action 内做权限校验，
self.check_object_permissions(request, obj)不适用，得手动查request.user和 queryset
用 restframework-bulk 但小心 unique=True 字段
这个包能快速接入批量增删改，但遇到 UniqueValidator 就容易崩，错误典型是 AttributeError: 'list' object has no attribute 'pk'。
立即学习“Python免费学习笔记（深入）”；
- 根本原因是其批量更新逻辑把整个 queryset 当作
instance传给序列化器，而 DRF 的UniqueValidator.exclude_current_instance()期望 instance 是单个 model 对象，不是 list - 只要模型里有
unique=True字段（比如name=models.CharField(unique=True)），就会触发这个 bug - 绕过方法：要么去掉 unique 约束（不推荐），要么在序列化器中重写
run_validation()手动跳过唯一性检查，或改用数据库层约束 + 捕获 IntegrityError - 它不兼容
ModelSerializer中自定义的create()/update()方法——这些方法不会被批量路径调用
批量更新慎用 ORM 层的 bulk_update() 直连
如果业务逻辑简单（仅字段赋值，无信号、无 clean、无外键级联），直接用 Django ORM 的 bulk_update() 效率最高，但和 DRF 序列化器脱钩。
-
bulk_update()绕过所有模型层逻辑，包括save()、pre_save信号、字段default或auto_now - 必须显式指定要更新的字段名列表，如
['status', 'updated_at']，漏写字段不会被修改 - 无法按条件更新（比如只更新 status='pending' 的记录），得先
.filter()出 queryset 再 bulk_update - 若前端传的是完整对象（含只读字段），需提前从
request.data中剥离，否则可能触发数据库报错
真正难的不是怎么写批量接口，而是决定哪些逻辑必须走 DRF 序列化器（比如密码哈希、状态机校验），哪些可以下推到 ORM 层（比如时间戳更新、计数器累加）。混用时最容易漏掉的是事务边界和错误回滚粒度。
