Django模型ImageField如何动态设置上传文件子目录路径

Django的ImageField/FileField的upload_to参数原生支持传入可调用对象动态生成存储路径，你只需要按以下步骤配置，同时处理好自增主键的取值时机即可。 #

1. 编写自定义路径生成函数 #

upload_to传入的可调用对象需要接收两个固定参数：当前模型实例instance、上传文件的原始文件名filename，返回最终的存储相对路径（相对于你配置的MEDIA_ROOT）。
在你的models.py同目录下编写函数：

import os
from datetime import datetime

def get_student_photo_path(instance, filename):
    # 取关联用户的用户名
    username = instance.user.username
    # 取学生学号
    std_no = instance.std_no
    # 取上传当日的年、月、日，补零对齐两位月/日
    now = datetime.now()
    year, month, day = now.strftime("%Y"), now.strftime("%m"), now.strftime("%d")
    # 保留文件原始扩展名
    file_ext = os.path.splitext(filename)[1]
    # 拼接最终路径，若需要自定义文件名可自行修改最后一段，示例保留原始文件名
    return f"student/{username}/{std_no}/{year}/{month}/{day}/{filename}"

小提示：如果你的用户名可能包含/、\这类路径非法字符，提前对username做一次字符替换即可，比如username = instance.user.username.replace("/", "_").replace("\\", "_")，避免路径错乱。

2. 修改模型字段配置 #

将photo字段原来硬编码的upload_to="student/"替换为上面编写的函数，注意不要加括号，直接传函数对象本身：

@reversion.register()
class Student(BaseModel):
    uuid = models.UUIDField(default=uuid.uuid4, verbose_name=_("Unique Identifier"), unique=True)
    user = models.OneToOneField(User, on_delete=models.PROTECT, db_index=True, verbose_name=_("User"))
    # 替换upload_to为自定义路径函数
    photo = models.ImageField(upload_to=get_student_photo_path, null=True, blank=True, verbose_name=_("Photo"))
    std_status = models.IntegerField(choices=STD_STATUS, default=1, verbose_name=_("Stu Sta"))
    std_no = models.AutoField(primary_key=True, verbose_name=_("Stu Num"))
    name = models.CharField(max_length=100, db_index=True, verbose_name=_("Name"))
    surname = models.CharField(max_length=100, db_index=True, verbose_name=_("Surname"))

3. 调整保存逻辑适配自增主键 #

你模型里的std_no是AutoField自增主键，新实例第一次写入数据库之前，这个字段是没有实际值的，如果直接在表单提交时一次性保存所有字段，会因为拿不到std_no导致路径生成失败。按照以下逻辑调整视图/表单的保存流程即可：

• 表单校验通过后，先给实例赋值除photo外的所有字段（user、姓名、学籍状态等）
• 先执行一次数据库写入，拿到自增生成的std_no值
• 再给photo字段赋值上传的文件，执行第二次保存，此时路径生成函数可以拿到完整的user、std_no、上传日期参数，Django默认存储后端会自动递归创建所有不存在的层级目录，不需要手动调用接口创建文件夹。

如果你用Django的ModelForm实现表单，参考以下保存逻辑：

def student_create_view(request):
    if request.method == "POST":
        form = StudentForm(request.POST, request.FILES)
        if form.is_valid():
            student = form.save(commit=False)
            # 第一次存库：不存photo，先拿到自增std_no
            student.photo = None
            student.save()
            # 第二次存库：赋值photo后保存，自动生成目标路径
            student.photo = request.FILES.get("photo")
            student.save()
            # 后续跳转逻辑正常写即可
            return redirect("student_list")
    else:
        form = StudentForm()
    return render(request, "student_form.html", {"form": form})

如果是更新已有学生信息的场景，不需要做特殊处理：实例已经存在于数据库，user和std_no都有持久化的值，直接保存就会自动生成正确的存储路径。

内容的提问来源于stack exchange，提问作者ivbtar