Wagtail中如何让User.is_active作为@property实现用户管理？

当将自定义User模型的is_active定义为Python的@property（而非数据库字段）时，会触发以下Django字段错误：

django.core.exceptions.FieldError: Unknown field(s) (is_active) specified for User

自定义User模型代码示例：

class User(AbstractBaseUser, PermissionsMixin):
    @property
    def is_active(self):
        return ....  # 自定义激活状态判断逻辑

冲突原因 #

Wagtail默认的wagtail.users.forms.UserEditForm在Meta类的fields集合中包含了"is_active"字段，即使在项目settings中配置了自定义表单（如下），只要wagtail.users在INSTALLED_APPS内，错误依然会触发：

WAGTAIL_USER_EDIT_FORM = 'users.forms.CustomUserEditForm'
WAGTAIL_USER_CREATION_FORM = 'users.forms.CustomUserCreationForm'

目前无法完全禁用Wagtail的用户管理功能，以下是可行的解决方案：

解决方案 #

方法1：覆盖Wagtail表单并移除is_active字段 #

创建自定义的User编辑表单，继承Wagtail的默认表单并明确移除is_active字段：

# users/forms.py
from wagtail.users.forms import UserEditForm as WagtailUserEditForm
from .models import User

class CustomUserEditForm(WagtailUserEditForm):
    class Meta(WagtailUserEditForm.Meta):
        model = User
        # 从原字段集合中剔除is_active
        fields = WagtailUserEditForm.Meta.fields - {"is_active"}

确保settings中的表单配置指向这个自定义类：

# settings.py
WAGTAIL_USER_EDIT_FORM = 'users.forms.CustomUserEditForm'

方法2：添加虚拟字段兼容表单识别 #

如果需要在表单中保留is_active的展示（只读），可以给User模型添加一个不映射到数据库的虚拟字段，让Django和Wagtail能够识别它：

from django.db import models
from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin

class User(AbstractBaseUser, PermissionsMixin):
    # 定义虚拟字段，editable设为False避免数据库迁移
    is_active = models.BooleanField(editable=False)

    @property
    def is_active(self):
        return ....  # 自定义激活状态逻辑

    # 添加setter避免赋值报错
    @is_active.setter
    def is_active(self, value):
        # 因是属性字段，无需实际赋值，或根据需求处理
        pass

若要在表单中展示该字段为只读，可在自定义表单中设置：

class CustomUserEditForm(WagtailUserEditForm):
    is_active = forms.BooleanField(disabled=True)

方法3：通过Wagtail钩子动态移除字段 #

使用Wagtail的register_user_edit_form钩子，在运行时动态移除表单中的is_active字段，无需修改表单类：

# users/wagtail_hooks.py
from wagtail.core import hooks

@hooks.register('register_user_edit_form')
def remove_is_active_from_edit_form(form_class):
    if 'is_active' in form_class.base_fields:
        del form_class.base_fields['is_active']
    return form_class

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