Django表单上传文件在编辑更新页面不显示的问题求助

提交包含文件的表单后，进入编辑/更新页面时，表单内所有数据正常显示，但上传的文件无法显示、无法访问，推测问题出在views.py（该视图同时处理表单首次保存与编辑展示逻辑），相关代码及配置如下：

views.py #

def contract_form(request, id=0):
    if request.method == "GET":
        if id == 0:
            form = ContractsForm(request.FILES)
        else:
            contratos = Contratos.objects.get(pk=id)
            form = ContractsForm(instance=contratos)
        return render(request, "contracts_form.html", {'form': form})
    else:
        if id == 0:
            form = ContractsForm(request.POST, request.FILES)
        else:
            contratos = Contratos.objects.get(pk=id)
            form = ContractsForm(request.POST, request.FILES, instance=contratos)
        if form.is_valid():
            form.save()
            messages.success(request, "Form submission successful")
        else:
            messages.error(request, "Error, contract not submitted")

        return redirect('/contracts')

models.py #

attached_file = models.FileField(upload_to="media", blank=True)

前端表单声明 #

<form enctype="multipart/form-data" action="" method="post" autocomplete="off" class="row g-3">

contracts_form.html #

<label for="{{ form.subject.id_for_label }}">Attached File:</label>
{{ form.attached_file }}
{% if Contracts.media %}
<a href="{{ Contracts.media.url }}"></a>
{% endif %}

settings.py #

MEDIA_ROOT = os.path.join(BASE_DIR, 'uploads/')
MEDIA_URL = "/contracts-media/"

路由配置 #

path('contracts/edit/<int:id>', views.contract_form, name='edit'),  # edit/update form
path('contracts/add', views.contract_form, name='new-contract'),  # add a contract

] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

问题修复方案 #

1. 修正前端模板变量错误
   模板中Contracts.media是无效变量，应直接使用表单绑定的实例字段。修改contracts_form.html：

<label for="{{ form.attached_file.id_for_label }}">Attached File:</label>
{{ form.attached_file }}
{% if form.instance.attached_file %}
    <a href="{{ form.instance.attached_file.url }}">查看已上传文件</a>
{% endif %}

说明：form.instance对应当前编辑的Contratos对象，直接判断attached_file是否存在，存在则生成文件访问链接。

2. 移除GET新建表单的冗余参数
   GET请求新建表单时，无需传递request.FILES，修改views.py中GET分支的代码：

if id == 0:
    form = ContractsForm()  # 去掉request.FILES参数

3. 确认文件存储路径与权限
   models.py中upload_to="media"结合settings.py的MEDIA_ROOT=uploads/，文件实际存储路径为uploads/media/，需确保该目录存在且服务器进程有读写权限，可手动创建目录或配置自动生成。

4. 验证文件保存状态
   通过Django admin或shell查看对应Contratos实例的attached_file字段值，确认文件路径正确，且服务器对应目录下存在该文件。

5. 静态文件服务配置
   开发环境下已通过static()函数配置媒体文件路由，生产环境需改用Nginx/Apache等服务配置媒体文件的访问路径，不能依赖Django的static函数。

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