表单中用Model.objects.filter致无法更新模型的解决方法

你遇到的问题本质是：表单类在模块加载阶段就会执行queryset和initial中的数据库查询，而Django执行迁移时会加载所有应用的代码（包括表单类）。此时新字段还未被添加到数据库，查询自然会抛出UndefinedColumn错误。

核心思路是延迟数据库查询的执行时机，不要在类定义阶段直接执行查询，而是把查询逻辑放到表单的__init__方法中（只有当表单被实例化时才会执行这部分代码，迁移过程中不会触发）。

修改后的代码示例：

class TestModelChoiceField(forms.ModelChoiceField):
    """
    重写ModelChoiceField，自定义选项显示文本
    """
    def label_from_instance(self, obj):
        return obj.test_field


class TestForm(forms.Form):
    # 初始化时先设置空的queryset，避免模块加载时触发查询
    first_select = TestModelChoiceField(
        queryset=TestModel.objects.none(),
        label="Field One:"
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 在实例化阶段才执行数据库查询
        filtered_queryset = TestModel.objects.filter(model_attribute__isnull=False)
        self.fields['first_select'].queryset = filtered_queryset
        
        # 设置初始值，同样延迟查询
        initial_instance = filtered_queryset.filter(test_field="Yes").first()
        if initial_instance:
            self.fields['first_select'].initial = initial_instance.team_id

• 用TestModel.objects.none()作为初始queryset，不会触发任何数据库操作，仅作为占位使用。
• 所有涉及数据库查询的逻辑都移到__init__方法中，确保只有在实际使用表单（比如前端渲染、提交处理）时才会执行查询，迁移过程中不会触及这部分代码。

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