解决Flask-Admin中用户管理的字段不显示与AttributeError问题

问题1：Admin/User页面Phone Numbers字段未显示 #

原因 #

Flask-Admin默认ModelView仅展示模型的直接列字段，不会自动加载并显示关联关系字段（比如User中的phone_numbers是一对多关系）。

修复方案 #

自定义ModelView，显式指定列表页要展示的字段，并为关联字段添加格式化逻辑，让电话号码以可读形式显示。

问题2：创建/编辑用户触发AttributeError: 'tuple' object has no attribute 'items' #

原因 #

1. User模型采用SQLAlchemy多态继承设计，Flask-Admin默认表单生成逻辑无法正确处理多态模型的字段映射，导致内部生成了错误格式的表单配置。
2. 一对一关系account的默认表单字段生成逻辑存在问题，返回了元组而非预期的字典格式。

修复方案 #

自定义ModelView，覆盖表单生成逻辑，排除多态相关字段，手动处理关联关系的表单展示，避免格式错误。

完整修复代码 #

修改admin.py文件 #

from flask_admin import Admin
from flask_admin.contrib.sqla import ModelView
from app.models import User, PhoneNumber, Account
from app.extensions import db
from wtforms import SelectField

class UserModelView(ModelView):
    # 列表页显示的字段，包含关联字段
    column_list = ('id', 'last_name', 'first_name', 'email', 'role', 'phone_numbers', 'account')
    
    # 自定义phone_numbers字段的展示内容
    def _format_phone_numbers(view, context, model, name):
        return ', '.join([pn.number for pn in model.phone_numbers])
    
    # 注册自定义列格式化函数
    column_formatters = {
        'phone_numbers': _format_phone_numbers,
        'account': lambda v,c,m,n: m.account.user_name if m.account else '无'
    }
    
    # 表单页排除不需要自动生成的字段，避免多态和关联关系的错误
    form_excluded_columns = ('role', 'phone_numbers', 'account')
    
    # 手动添加account的选择字段（适配一对一关系）
    form_extra_fields = {
        'account_id': SelectField(
            'Account',
            choices=[(acc.id, acc.user_name) for acc in Account.query.all()],
            coerce=int
        )
    }
    
    # 处理多态模型的表单生成问题，移除自动生成的冲突字段
    def create_form(self, obj=None):
        form = super().create_form(obj)
        if hasattr(form, 'role'):
            del form.role
        return form
    
    def edit_form(self, obj=None):
        form = super().edit_form(obj)
        if hasattr(form, 'role'):
            del form.role
        return form

def init_admin(app):
    admin = Admin(app, name="Admin Panel", template_mode="bootstrap4")
    # 使用自定义的UserModelView替代默认ModelView
    admin.add_view(UserModelView(User, db.session))
    admin.add_view(ModelView(PhoneNumber, db.session))

额外优化建议 #

如果需要在用户编辑页面直接管理电话号码，无需跳转至PhoneNumber页面，可以添加内嵌表单支持：

from flask_admin.contrib.sqla.fields import InlineModelFormList

class UserModelView(ModelView):
    # ... 保留原有配置 ...
    inline_models = (PhoneNumber,)

添加后，用户编辑页会自动显示电话号码的内嵌增删改表单，提升管理效率。

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