如何在引用字段缺失/删除时仍加载Flask Admin ListView

可以通过重写Flask Admin的ModelView相关方法，捕获MongoEngine的DoesNotExist异常，让列表视图在遇到已删除的引用字段时仍能正常加载，具体实现如下：

方案一：通用异常捕获的自定义ModelView #

创建继承自ModelView的自定义类，重写字段值格式化方法，捕获引用文档不存在的异常并返回占位文本：

from flask_admin.contrib.mongoengine import ModelView
from mongoengine.errors import DoesNotExist

class SafeReferenceModelView(ModelView):
    def _format_value(self, value):
        try:
            # 调用父类逻辑处理正常引用
            return super()._format_value(value)
        except DoesNotExist:
            # 引用文档已删除时返回占位提示
            return "*已删除*"

注册ModelView时使用这个自定义类：

# 替换原有ModelView注册代码
admin.add_view(SafeReferenceModelView(DisplayType, name="显示类型"))

方案二：针对特定字段的精细处理 #

如果需要对单个字段做个性化处理，可通过column_formatters自定义渲染逻辑，同时保留全局异常捕获：

class DisplayTypeModelView(ModelView):
    # 单独处理section字段的渲染
    column_formatters = {
        'section': lambda view, context, model, name: 
            getattr(model.section, 'score', "*已删除*") if model.section.id else "*已删除*"
    }

    def _format_value(self, value):
        try:
            return super()._format_value(value)
        except DoesNotExist:
            return "*已删除*"

原理说明 #

Flask Admin渲染列表视图时会自动解引用MongoEngine的ReferenceField，当引用文档被删除后，解引用过程会抛出DoesNotExist异常导致页面崩溃。通过重写字段格式化方法并捕获该异常，用占位文本替代错误内容，可确保列表视图正常加载其余数据。

该方案仅在Admin展示层做兼容处理，无需修改数据模型或数据库操作逻辑，适配多API独立MongoEngine实例无法使用reverse_delete_rule的场景。

内容的提问来源于stack exchange，提问作者Lord of the Strings