如何在Python Django REST Framework中实现多图上传并自动生成缩略图？-Python教程-PHP中文网

drf中接收多图上传必须用request.files.getlist('images')获取文件列表，而非request.data.get('images')；前端需用formdata.append('images', file)多次提交，后端须校验数量、大小及图像格式，并在视图中手动处理而非依赖序列化器自动展开。

如何在python django rest framework中实现多图上传并自动生成缩略图？

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 阻塞主线程。

Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...

下载

必须用 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），就得手动控制文件写入。

原图走 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')) （防爆内存），并逐个检查 <code>file.size 1024 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/..."}]