Django inlineformset_factory自定义验证后非表单错误不显示

你遇到的问题核心在于错误的层级和模板渲染位置不匹配，以及当前的验证错误抛出方式导致错误没有被正确关联到可渲染的位置。下面分两种方案帮你解决：

方案1：快速显示全局表单集错误（适合快速调试） #

你在clean方法中直接raise forms.ValidationError，这个错误属于整个表单集的非表单错误（non-form errors），而非单个表单的错误。你的模板里只渲染了单个表单的{{ form.non_form_errors }}，没有渲染整个表单集的错误信息。

修改模板，在management_form下方添加表单集的错误渲染：

<table class="table">
    {{inlines.management_form}}
    <!-- 添加这一行，显示表单集全局错误 -->
    {{ inlines.non_form_errors }}
    {%for form in inlines.forms%}
        {% if forloop.first%}
            <thead>
                <tr>
                    {%for field in form.visible_fields%}
                        <th>{{field.label|capfirst}}</th>
                    {%endfor%}
                </tr>
            </thead>
        {%endif%}
        <tr class="formset_row">
            {{ form.non_form_errors }}
            {% for field in form.visible_fields %}
                <td>
                    {% if forloop.first %}
                        {% for hidden in form.hidden_fields %}
                            {{ hidden }}
                        {% endfor %}
                    {% endif %}
                    {{ field }}
                </td>
            {% endfor %}
        </tr>
    {% endfor %}
</table>

这样就能看到你抛出的"not enough products"错误了。

方案2：将错误关联到具体字段（推荐，用户体验更好） #

全局错误对用户不够友好，最好把错误绑定到出错的表单字段上，让用户一眼看到是哪一行的哪个输入有问题。

修改表单集的clean方法 #

不要全局抛出错误，而是给具体表单的字段添加错误：

class BaseDetailFormSet(forms.BaseInlineFormSet):
    def clean(self):
        super().clean()  # 简化super调用写法
        if any(self.errors):
            return
        
        for form in self.forms:
            # 跳过被标记为删除的表单，以及没有数据的空表单
            if not form.cleaned_data or form.cleaned_data.get('DELETE', False):
                continue
            
            product = form.cleaned_data['product']
            quantity_sold = form.cleaned_data['quantity_sold']
            if quantity_sold > product.quantity_in_stock:
                # 将错误关联到quantity_sold字段
                form.add_error(
                    'quantity_sold', 
                    _('Not enough stock: only %(stock)s available') % {'stock': product.quantity_in_stock}
                )

修改模板渲染字段错误 #

在每个字段的下方添加字段错误的渲染：

<td>
    {% if forloop.first %}
        {% for hidden in form.hidden_fields %}
            {{ hidden }}
        {% endfor %}
    {% endif %}
    {{ field }}
    <!-- 添加这一行，显示当前字段的错误 -->
    {{ field.errors }}
</td>

这样错误会直接显示在对应的quantity_sold输入框下方，用户能清晰知道哪一行的数量输入不符合要求。

为什么原来的错误不显示？ #

你抛出的ValidationError属于表单集级别的全局错误，而你的模板只渲染了单个表单的非表单错误，没有渲染整个表单集的全局错误容器，所以错误信息无法被展示出来。通过上面的两种方案，要么渲染全局错误，要么把错误绑定到具体字段，就能解决问题。

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