MultiPartParser 是 Django 默认处理图片上传的解析器，它自动解析 multipart/form-data 请求，将文件存入 request.FILES、表单字段存入 request.POST，无需手动调用；使用时需确保前端用 FormData 发送、后端通过 request.FILES 安全校验并用 default_storage.save() 保存，再拼接 MEDIA_URL 返回可访问 URL。
MultiPartParser 是 Django 默认处理图片上传的解析器
Django 在接收到 multipart/form-data 类型请求时，会自动启用 MultiPartParser ——你不需要手动调用它，也不该去替换或绕过它。只要前端用 FormData 正确构造请求，后端用 request.FILES 取文件，Django 就已走通了这条链路。
常见错误是试图用 json.loads(request.body) 去解析带文件的请求，结果得到空字典或 JSONDecodeError：因为 request.body 对 multipart 请求不可靠，Django 已把文件部分剥离到 request.FILES，表单字段则在 request.POST 中。
- 确保视图函数/类接收的是
request对象（不是被中间件或装饰器意外修改过的） - 检查请求头是否包含
Content-Type: multipart/form-data; boundary=...（浏览器FormData自动设置，手写 fetch 时别硬写成application/json） - 如果用了 DRF，别混淆
APIView和View：DRF 的APIView默认支持MultiPartParser，但需显式声明parser_classes = [MultiPartParser]（尤其在混合 JSON + 文件场景下）
怎么安全地从 request.FILES 提取并保存图片
request.FILES 是个类似字典的对象，键名来自 HTML 表单的 name 属性或前端 FormData.append('image', file) 的第一个参数。直接取值前必须校验是否存在、是否为文件对象、是否有内容。
if 'image' not in request.FILES:
return JsonResponse({'error': 'Missing image field'}, status=400)
<p>uploaded_file = request.FILES['image']
if not uploaded_file.name.lower().endswith(('.png', '.jpg', '.jpeg', '.webp')):
return JsonResponse({'error': 'Unsupported file type'}, status=400)</p><p>if uploaded_file.size > 5 <em> 1024 </em> 1024: # 5MB
return JsonResponse({'error': 'File too large'}, status=400)注意：uploaded_file.read() 会消耗文件流，后续再读会返回空 bytes；保存时优先用 Django 的 default_storage.save() 而非手动 open/write，避免权限、路径拼接、编码等低级错误。
立即学习“Python免费学习笔记（深入）”；
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
上传后图片 URL 怎么返回给前端
Django 不自动提供可访问的 URL，你需要自己拼。关键点在于 settings.MEDIA_URL 和 settings.MEDIA_ROOT 必须配对且生效：
-
MEDIA_ROOT是文件实际保存的绝对路径（如/var/www/myapp/media/） -
MEDIA_URL是 URL 前缀（如/media/），必须以/开头和结尾 - 开发时需在根 URLconf 中显式添加
static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)，否则 Nginx/Apache 不会服务这些文件
保存后生成 URL 示例：
from django.core.files.storage import default_storage
from django.conf import settings
<p>file_path = default_storage.save(f'uploads/{uploaded_file.name}', uploaded_file)
url = f'{settings.MEDIA_URL}{file_path}' # 如 '/media/uploads/photo.jpg'别用 os.path.join(settings.MEDIA_URL, ...) —— MEDIA_URL 是 URL 段，不是文件路径。
为什么本地能传、生产环境 400 或 500？
生产环境出问题，90% 出在 Web 服务器配置而非 Django 代码本身：
- Nginx 默认限制单个请求体大小（
client_max_body_size），上传大图时直接 413 Request Entity Too Large；需在http、server或location块中设为足够值，如client_max_body_size 10M; - uWSGI/Gunicorn 也有请求体限制（如 uWSGI 的
--limit-post），需同步调整 - 如果用了 CDN 或 API 网关（如 AWS ALB），它们可能默认拦截 multipart 请求或限制 body 大小，需单独放开
调试时先关掉所有中间件、用 curl 直连 Django（绕过 Nginx），确认逻辑无误后再逐层排查代理层限制。
