Wagtail中FieldPanel导入失败：自定义AbstractUser模型配置报错求助

嘿，这个问题我太熟了！你遇到的ImportError: cannot import name 'FieldPanel'完全是因为Wagtail 2.0对后台编辑面板的模块结构做了调整——原来的FieldPanel从wagtail.admin.edit_handlers模块移到了wagtail.admin.panels里，而你参考的示例可能是基于Wagtail旧版本写的，所以才会报错。

下面是一步步的解决方法：

1. 修正FieldPanel的导入路径 #

不管你是在models.py还是admin.py里导入FieldPanel，都要把旧的导入语句替换成新的：

# 旧的（错误）
from wagtail.admin.edit_handlers import FieldPanel

# 新的（正确）
from wagtail.admin.panels import FieldPanel

如果你的代码里还用到了MultiFieldPanel、InlinePanel这类面板，也要同步改成从wagtail.admin.panels导入。

2. 确保自定义User模型的配置完整 #

结合你的环境（Django 1.11.3 + Wagtail 2.0），给你一份标准的自定义User模型示例，你可以对照调整：

（1）blog/models.py中的User模型 #

from django.contrib.auth.models import AbstractUser
from django.db import models
from wagtail.admin.panels import FieldPanel
from wagtail.fields import RichTextField
from wagtail.images.models import Image
from wagtail.images.edit_handlers import ImageChooserPanel

class User(AbstractUser):
    # 这里可以添加自定义字段，比如个人简介、头像
    bio = RichTextField(blank=True)
    profile_image = models.ForeignKey(
        Image,
        null=True,
        blank=True,
        on_delete=models.SET_NULL,
        related_name='+'
    )

    # Wagtail后台编辑面板配置
    panels = [
        FieldPanel('username'),
        FieldPanel('email'),
        FieldPanel('first_name'),
        FieldPanel('last_name'),
        ImageChooserPanel('profile_image'),
        FieldPanel('bio'),
        FieldPanel('is_active'),
        FieldPanel('is_staff'),
        FieldPanel('is_superuser'),
        FieldPanel('groups'),
        FieldPanel('user_permissions'),
    ]

（2）创建blog/admin.py注册自定义UserAdmin #

from django.contrib.auth.admin import UserAdmin as DjangoUserAdmin
from django.contrib.auth.forms import UserChangeForm, UserCreationForm
from django.utils.translation import ugettext_lazy as _
from wagtail.contrib.modeladmin.options import (
    ModelAdmin, modeladmin_register
)

from .models import User

# 自定义表单，适配我们的User模型
class CustomUserChangeForm(UserChangeForm):
    class Meta(UserChangeForm.Meta):
        model = User

class CustomUserCreationForm(UserCreationForm):
    class Meta(UserCreationForm.Meta):
        model = User

# 自定义UserAdmin类，集成Wagtail的ModelAdmin
class UserAdmin(ModelAdmin):
    model = User
    menu_label = _('Users')
    menu_icon = 'user'
    menu_order = 290
    add_to_settings_menu = False
    exclude_from_explorer = False
    add_form = CustomUserCreationForm
    edit_form = CustomUserChangeForm
    list_display = ('username', 'email', 'first_name', 'last_name', 'is_staff')
    search_fields = ('username', 'email', 'first_name', 'last_name')

# 注册到Wagtail后台
modeladmin_register(UserAdmin)

（3）确保blog/apps.py中的ready方法正确 #

如果你的apps.py里没有ready方法，加上它确保admin注册生效：

from django.apps import AppConfig

class BlogConfig(AppConfig):
    name = 'blog'

    def ready(self):
        import blog.admin  # 导入admin模块触发注册

3. 收尾操作 #

做完上面的修改后，执行以下命令确保迁移生效：

# 生成迁移文件
./manage.py makemigrations blog

# 应用迁移
./manage.py migrate

# 重启服务器
./manage.py runserver

注意：如果你是中途修改的用户模型（之前已经用默认User模型做过迁移），可能需要清理数据库后重新迁移（记得备份数据！），否则可能会出现其他冲突。

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