DRF中接收多图上传必须用request.FILES.getlist('images')获取文件列表，而非request.data.get('images')；前端需用FormData.append('images', file)多次提交，后端须校验数量、大小及图像格式，并在视图中手动处理而非依赖序列化器自动展开。
DRF中接收多图上传的正确写法
Django REST Framework 默认不支持 multipart/form-data 中多个同名 file 字段的自动解析。直接在 request.data.get('images') 拿到的通常是单个 InMemoryUploadedFile，而非列表——这是最常踩的坑。
必须显式用 request.FILES.getlist('images') 获取全部文件对象。如果前端用 FormData.append('images', file) 多次追加，后端就只能靠 getlist；若用 FormData.set('images', file)，则只会保留最后一个。
- 视图里别依赖
serializer.validated_data['images']自动展开，除非你重写了to_internal_value - 推荐在
APIView或GenericAPIView的post方法里先处理request.FILES.getlist('images') - 若用
ModelSerializer，需配合自定义ImageField子类或覆盖create方法，否则会报Expected a list of items but got type "InMemoryUploadedFile"
用Pillow生成缩略图的关键控制点
缩略图不是简单调 resize() 就完事。常见问题：比例失真、白边、质量崩坏、I/O 阻塞主线程。
- 必须用
thumbnail()（保持比例裁剪）而非resize()（暴力拉伸），传参是目标尺寸元组，如(300, 300) - 保存前务必调
img.format = 'JPEG'并指定quality=85，否则 PNG 透明通道可能丢失，JPEG 默认质量低至 75 容易发虚 - 缩略图文件名建议基于原图名 + 尺寸后缀生成，例如
original.jpg → original_300x300.jpg，避免覆盖和缓存混淆 - 不要直接在视图里同步生成——大图+多图时会卡住整个请求，应丢给
django-rq或celery异步处理，哪怕只是用threading.Thread简单包裹也比阻塞强
保存多图及缩略图到不同存储路径
Django 的 ImageField 默认只存一个文件路径，但你要存原图 + 多套缩略图（比如 300x300、800x600），就得手动控制文件写入。
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
立即学习“Python免费学习笔记（深入）”；
- 原图走
model_instance.image.save(name, content, save=False)，缩略图则用default_storage.save(thumb_path, ContentFile(thumb_bytes)) - 路径组织推荐按日期分层：
uploads/images/2024/06/15/original.jpg和uploads/images/2024/06/15/thumbs/original_300x300.jpg - 注意
default_storage对MediaRoot和 S3 等后端透明，但本地开发时确保MEDIA_ROOT可写，且 Nginx/Apache 已配置/media/路由 - 如果用
django-storages+ S3，ContentFile必须设content_type='image/jpeg'，否则 S3 可能返回Content-Type: binary/octet-stream导致浏览器不渲染
前端传图与后端校验的配合细节
很多问题其实出在前后端约定断裂：前端没设 enctype="multipart/form-data"，或没正确 append 多个文件，而后端还傻等列表。
- 前端必须用
FormData，且每个文件调一次append('images', file)，不能append('images', [file1, file2]) - 后端应校验
len(request.FILES.getlist('images')) <= 10（防爆内存），并逐个检查file.size < 10 <em> 1024 </em> 1024（10MB） - 对非图像类型（如
application/pdf）要提前拒绝，用Image.open(file).format in ['JPEG', 'PNG', 'WEBP']实际验证，别只信file.content_type - 返回结果里别只返回缩略图 URL 列表，得带原始文件名和尺寸信息，方便前端做响应式展示，例如：
[{"name": "a.jpg", "original_url": "/media/...", "thumb_300_url": "/media/..."}]
缩略图生成逻辑本身不难，难的是边界：空文件、超大图、非图文件、并发写冲突、S3 权限错误、Pillow 解码异常——这些全得包在 try/except 里，且每种错误要返回可定位的提示，而不是让整个 API 500。
