Django：在表单中添加关联模型（ForeignKey）字段的实现问题

看起来你是要在Django里给主模型Entertainment和它的关联模型EntertainmentCollage做同一个编辑页面对吧？我之前也碰到过类似的需求，下面分两种常用场景给你讲解决方案：

一、如果是Django Admin后台的编辑页面 #

这是最简单的情况，用InlineModelAdmin就能快速实现关联模型的内嵌编辑：

步骤1：完善关联模型（补全外键关系） #

首先确保EntertainmentCollage有指向Entertainment的外键（先补全你没写完的模型代码）：

from django.db import models

class Entertainment(models.Model):
    main_photo = models.ImageField(upload_to='where/')
    place = models.CharField(max_length=200)
    description = models.CharField(max_length=200)
    event_date = models.DateTimeField(auto_now_add=False, blank=True, null=True)

class EntertainmentCollage(models.Model):
    entertainment = models.ForeignKey(
        Entertainment, 
        on_delete=models.CASCADE, 
        related_name='collages'  # 这个属性方便后续反向查询关联数据
    )
    collage_photo = models.ImageField(upload_to='entertainment_collages/')
    # 可根据需求添加其他字段，比如排序序号、备注等

步骤2：在admin.py中配置Inline和主模型Admin #

from django.contrib import admin
from .models import Entertainment, EntertainmentCollage

# 定义关联模型的Inline类
class EntertainmentCollageInline(admin.TabularInline):  # TabularInline是表格布局，StackedInline是堆叠布局
    model = EntertainmentCollage
    extra = 1  # 默认显示1个空输入框，方便添加新的Collage条目
    # 可按需添加fields、readonly_fields等限制编辑权限

# 配置主模型的Admin
@admin.register(Entertainment)
class EntertainmentAdmin(admin.ModelAdmin):
    inlines = [EntertainmentCollageInline]  # 将Inline关联到主模型Admin
    # 可继续配置主模型的其他Admin属性，比如list_display、fieldsets等

配置完成后，在Admin后台编辑Entertainment时，页面下方会直接显示对应的EntertainmentCollage编辑区域，新增、修改、删除操作都能直接完成，Django会自动处理关联数据的保存逻辑。

二、如果是自定义的前端编辑页面（自行编写视图和模板） #

这种情况需要用到Django的ModelFormSet来处理关联模型的表单集合，步骤如下：

步骤1：定义主模型表单和关联模型的FormSet #

from django import forms
from django.forms import modelformset_factory
from .models import Entertainment, EntertainmentCollage

# 主模型的表单
class EntertainmentForm(forms.ModelForm):
    class Meta:
        model = Entertainment
        fields = ['main_photo', 'place', 'description', 'event_date']

# 关联模型的FormSet，用modelformset_factory创建
EntertainmentCollageFormSet = modelformset_factory(
    EntertainmentCollage,
    fields=['collage_photo'],  # 指定要编辑的字段
    extra=1,  # 默认显示1个空表单
    can_delete=True  # 显示删除复选框，允许删除已有Collage条目
)

步骤2：编写视图函数（以函数视图为例，类视图逻辑类似） #

from django.shortcuts import render, redirect
from .forms import EntertainmentForm, EntertainmentCollageFormSet

def edit_entertainment(request, pk):
    # 获取要编辑的主模型实例
    entertainment = Entertainment.objects.get(pk=pk)
    
    if request.method == 'POST':
        # 绑定主模型表单数据（包含文件上传，需传入request.FILES）
        form = EntertainmentForm(request.POST, request.FILES, instance=entertainment)
        # 绑定关联模型FormSet数据，同时过滤出当前Entertainment对应的Collage
        formset = EntertainmentCollageFormSet(
            request.POST, 
            request.FILES,
            queryset=EntertainmentCollage.objects.filter(entertainment=entertainment)
        )
        
        if form.is_valid() and formset.is_valid():
            # 先保存主模型
            entertainment = form.save()
            # 保存FormSet，手动设置每个Collage的外键关联
            collages = formset.save(commit=False)
            for collage in collages:
                collage.entertainment = entertainment
                collage.save()
            # 处理标记为删除的条目
            for obj in formset.deleted_objects:
                obj.delete()
            return redirect('entertainment_detail', pk=entertainment.pk)  # 跳转到详情页
    else:
        # GET请求时，初始化表单和FormSet
        form = EntertainmentForm(instance=entertainment)
        formset = EntertainmentCollageFormSet(queryset=EntertainmentCollage.objects.filter(entertainment=entertainment))
    
    return render(request, 'edit_entertainment.html', {
        'form': form,
        'formset': formset
    })

步骤3：编写模板（edit_entertainment.html） #

<form method="post" enctype="multipart/form-data">  <!-- 必须加enctype，否则文件无法正常上传 -->
    {% csrf_token %}
    
    <!-- 主模型表单区域 -->
    <h3>基本信息</h3>
    {{ form.as_p }}
    
    <!-- 关联模型FormSet区域 -->
    <h3>Collage图片</h3>
    {{ formset.management_form }}  <!-- 这个标签必须加，Django用来管理FormSet的数量和标识 -->
    {% for form in formset %}
        <div class="collage-form">
            {{ form.as_p }}
            {% if form.instance.pk %}
                <!-- 显示已上传的图片预览 -->
                <img src="{{ form.instance.collage_photo.url }}" alt="Collage预览" style="max-width: 200px; margin: 10px 0;">
            {% endif %}
        </div>
    {% endfor %}
    
    <button type="submit">保存修改</button>
</form>

关键注意事项 #

• 涉及文件上传（ImageField）时，表单必须添加enctype="multipart/form-data"属性，否则文件无法正确提交。
• 一对多关系中，外键的related_name建议设置清晰，方便后续反向查询关联数据。
• 使用FormSet保存时，commit=False后一定要手动设置外键再保存，否则会因外键为空抛出数据库错误。

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