Django图片上传API怎么写_Python基于MultiPartParser解析表单-Python教程-PHP中文网

multipartparser 是 django 默认处理图片上传的解析器，它自动解析 multipart/form-data 请求，将文件存入 request.files、表单字段存入 request.post，无需手动调用；使用时需确保前端用 formdata 发送、后端通过 request.files 安全校验并用 default_storage.save() 保存，再拼接 media_url 返回可访问 url。

django图片上传api怎么写_python基于multipartparser解析表单

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)</p>

注意：uploaded_file.read() 会消耗文件流，后续再读会返回空 bytes；保存时优先用 Django 的 default_storage.save() 而非手动 open/write，避免权限、路径拼接、编码等低级错误。

上传后图片 URL 怎么返回给前端

Django 不自动提供可访问的 URL，你需要自己拼。关键点在于 settings.MEDIA_URL 和 settings.MEDIA_ROOT 必须配对且生效：

python 查询技能

查询客流数据，输出JSON格式，可直接导入Bitable等可视化工具

下载

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'</p>

别用 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），确认逻辑无误后再逐层排查代理层限制。