使用django-crispy-forms的table_inline_formset模板出现多余行问题

问题原因分析 #

你遇到的多余空行，主要来自两个核心问题：

• 嵌套表单渲染异常：你的FormHelper未禁用自动生成表单标签，导致{% crispy %}输出的表单嵌套在已有外层表单中，引发意外渲染行为。
• 错误使用表单集工厂：对于Metric关联Occurrence的场景，应使用适配关联模型的inlineformset_factory，而非通用的modelformset_factory，后者会生成不符合业务场景的额外空表单行。

具体修复步骤 #

1. 修改FormHelper，禁用自动表单标签 #

在MetricFormSetHelper中添加self.form_tag = False，避免嵌套表单：

class MetricFormSetHelper(FormHelper):
    def __init__(self, *args, **kwargs):
        super(MetricFormSetHelper, self).__init__(*args, **kwargs)
        self.form_tag = False  # 禁用自动生成<form>标签，避免嵌套
        self.add_input(Submit('submit', 'Submit', css_class="btn btn-success"))
        self.template = 'bootstrap4/table_inline_formset.html'

2. 替换为inlineformset_factory适配关联模型 #

将views.py中的modelformset_factory替换为inlineformset_factory，并调整表单集初始化逻辑：

# 先导入inlineformset_factory
from django.forms import inlineformset_factory

@login_required
def create_occurrence(request, pk):
    try:
        site = Site.objects.get(id=pk)
    except Site.DoesNotExist:
        raise Http404("Site does not exist")
    form = OccurrenceForm(request.POST or None, initial={'site':site})
    
    # 替换为inlineformset_factory，适配Occurrence与Metric的关联关系
    MetricFormset = inlineformset_factory(
        Occurrence,  # 父模型
        Metric,      # 关联的子模型
        form=MetricForm,
        extra=3,
        can_delete=False  # 根据业务需求设置是否允许删除表单行
    )
    
    # 创建空的Occurrence实例（未保存不影响），用于初始化表单集
    empty_occurrence = Occurrence(site=site)
    formset = MetricFormset(instance=empty_occurrence)
    
    helper = MetricFormSetHelper()
    if form.is_valid():
        occurrence = form.save(commit=False)
        occurrence.added_by = request.user
        occurrence.site = site
        occurrence.save()
        form.save_m2m()
        
        # 使用已保存的occurrence实例初始化表单集
        metric_formset = MetricFormset(request.POST, instance=occurrence)
        if metric_formset.is_valid():
            # 无需手动遍历，save()会自动处理外键关联
            metric_formset.save()
        
        messages.success(request, "Occurrence created successfully.")
        execute_from_command_line(["../manage_dev.sh", "updatelayers", "-s", "archaeology"])
        return redirect(occurrence.get_absolute_url())
    context = {
        'form': form,
        'site':site,
        'formset':formset,
        'helper': helper,
    }
    return render(request, "archaeology/occurrence_form.html", context=context)

3. 移除模板中重复的管理字段渲染 #

删除模板里的{{ formset.management_form }}，因为{% crispy %}会自动渲染表单集所需的管理字段（如form-TOTAL_FORMS等），重复渲染会导致表单集数据混乱：

...
<form action="" method="post">
        {% csrf_token %}
        {{ form|crispy }}
        <h4>Metrics</h4>
        <!-- 移除这一行：{{ formset.management_form }} -->
        {% crispy formset helper %}
        {% if form.instance.pk != None %}
        <a class="btn btn-danger" href="{% url 'delete_occurrence' occurrence.id %}">{% trans "Delete" %}</a>
        {% endif %}
    </form>
...

额外说明 #

使用inlineformset_factory后，表单集会自动处理Metric与Occurrence的外键关联，无需手动遍历表单设置metric.occurrence = occurrence，直接调用metric_formset.save()即可完成所有关联数据的保存，代码更简洁可靠。

内容的提问来源于stack exchange，提问作者Rafael Sá