You need to enable JavaScript to run this app. Django 3.1.2下订单页用户上传/选择图片的模型存储实现示例
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 01:36:07