Django 3.1.2下订单页用户上传/选择图片的模型存储实现示例
适配Django 3.1.2的订单双模式图片选择功能实现
模型层设计
按照业务逻辑拆分独立模型,兼顾存量图关联和自上传图片存储的需求,避免单字段兼容两种来源带来的数据混乱:
- 单独建立平台存量图片模型,统一管理所有可供用户选择的预置图片资源
- 单独建立订单图片关联模型,支持空值关联两种图片来源,加来源标记字段方便后续逻辑分流
# models.py 兼容Django 3.1.2 ORM语法 from django.db import models from django.conf import settings class PlatformImage(models.Model): """平台存量公共图片库""" image = models.ImageField(upload_to="platform_stock/images/", verbose_name="存量图片文件") image_desc = models.CharField(max_length=100, blank=True, verbose_name="图片说明") create_time = models.DateTimeField(auto_now_add=True, verbose_name="入库时间") class Meta: verbose_name = "平台存量图片" verbose_name_plural = verbose_name class OrderImage(models.Model): """订单关联图片模型""" IMAGE_SOURCE_CHOICES = ( ('existing', '选择平台存量图'), ('uploaded', '用户自主上传'), ) order = models.ForeignKey("Order", on_delete=models.CASCADE, related_name="order_images", verbose_name="关联订单") # 关联存量图字段:允许为空,用户没选存量图时不占值 stock_image = models.ForeignKey(PlatformImage, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="关联存量图") # 用户上传图片字段:允许为空,用户没上传时不占值 uploaded_image = models.ImageField(upload_to="order/user_uploads/", null=True, blank=True, verbose_name="用户上传图片") image_source_type = models.CharField(max_length=20, choices=IMAGE_SOURCE_CHOICES, verbose_name="图片来源标记") class Meta: verbose_name = "订单关联图片" verbose_name_plural = verbose_name
表单层实现二选一交互校验
表单内置校验逻辑,强制用户必须二选一提交,同时拦截“两种来源同时提交”的非法请求:
# forms.py from django import forms from .models import PlatformImage class OrderImageSubmitForm(forms.Form): # 存量图选择下拉框 selected_stock_image = forms.ModelChoiceField( queryset=PlatformImage.objects.filter(is_active=True), required=False, empty_label="请选择平台存量图片", widget=forms.Select(attrs={"class": "form-control"}) ) # 本地上传文件框 uploaded_new_image = forms.ImageField( required=False, widget=forms.FileInput(attrs={"class": "form-control", "accept": "image/*"}) ) def clean(self): cleaned_data = super().clean() selected_img = cleaned_data.get("selected_stock_image") upload_img = cleaned_data.get("uploaded_new_image") # 校验规则:两个选项都为空时拦截 if not selected_img and not upload_img: raise forms.ValidationError("请选择操作:要么上传新图片,要么选择一张平台存量图片") # 校验规则:两个选项都填了时拦截 if selected_img and upload_img: raise forms.ValidationError("单次仅支持一种图片来源,请不要同时上传和选择存量图") return cleaned_data
视图层业务分流处理
根据表单校验后的合法提交内容,按来源分支写入对应模型字段:
# views.py from django.shortcuts import render, redirect from .forms import OrderImageSubmitForm from .models import OrderImage, Order def save_order_image(request, order_id): # 根据业务规则获取当前用户绑定的有效订单 current_order = Order.objects.get(id=order_id, user=request.user, is_valid=True) if request.method == "POST": # 处理文件上传必须显式传入request.FILES,Django3.1.2无自动解析 form = OrderImageSubmitForm(request.POST, request.FILES) if form.is_valid(): cleaned = form.cleaned_data # 分支1:用户选存量图,存关联关系 if cleaned.get("selected_stock_image"): OrderImage.objects.create( order=current_order, stock_image=cleaned["selected_stock_image"], image_source_type="existing" ) # 分支2:用户上传新图,存上传的文件内容 elif cleaned.get("uploaded_new_image"): OrderImage.objects.create( order=current_order, uploaded_image=cleaned["uploaded_new_image"], image_source_type="uploaded" ) return redirect("order_detail", order_id=order_id) else: form = OrderImageSubmitForm() return render(request, "order/save_image.html", {"form": form, "order": current_order})
模板层基础交互实现
无需复杂JS即可完成基础交互,后续可按需扩展图库弹窗、图片预览功能:
<!-- templates/order/save_image.html --> <form method="post" enctype="multipart/form-data"> {% csrf_token %} <div class="form-group mb-3"> <label>选择平台存量图片</label> {{ form.selected_stock_image }} <small class="text-muted">直接选择平台已提供的图片即可使用</small> </div> <div class="text-center my-2 text-muted">—— 或者 ——</div> <div class="form-group mb-3"> <label>上传本地图片</label> {{ form.uploaded_new_image }} <small class="text-muted">支持jpg/png格式,单张大小不超过5M</small> </div> {% if form.non_field_errors %} <div class="alert alert-danger"> {{ form.non_field_errors }} </div> {% endif %} <button type="submit" class="btn btn-primary w-100">保存图片关联</button> </form>
落地配置注意事项
- 项目settings需正确配置
MEDIA_URL、MEDIA_ROOT参数,否则上传的图片无法正常存储与访问 - 本地开发环境测试时,需在项目根路由中补充media文件的路由映射,不要直接套用生产环境的静态资源配置
- 存量图数量较多时,可将下拉选择替换为图库弹窗组件,后端存储逻辑无需调整即可兼容
内容的提问来源于stack exchange,提问作者Chauhan Mukesh
相关产品推荐
相关产品推荐

