Django：list_display可识别自定义VIN字段但list_filter报错如何解决

问题原因 #

Django 中list_display和list_filter两个属性的底层实现逻辑不同：

• list_display兼容两类值：一是模型对应的数据库表中真实存在的字段，二是ModelAdmin类中自定义的方法/属性，自定义值仅需要在Python层面计算后渲染到列表页即可，所以你写的自定义VIN方法可以正常展示。
• list_filter默认仅支持指向数据库中真实存在的字段，因为过滤需要生成SQL查询语句对全量数据集做筛选，你自定义的VIN是AppointmentAdmin类的方法，不属于Appointment模型的数据库字段，Django无法将其转换为合法的SQL过滤条件，因此触发admin.E116报错。

解决方案 #

你的自定义VIN实际读取的是关联外键unit的vin字段，可直接用Django原生支持的跨关联字段过滤规则解决，不需要自定义过滤逻辑：
将list_filter中的VIN替换为跨关联字段写法unit__vin即可，修改后的代码如下：

class AppointmentAdmin(admin.ModelAdmin):
    list_display = ('branch', 'date', 'timeslot', 'sold_to', 'unit', 'VIN')
    # 替换VIN为unit__vin
    list_filter = ('branch', 'date', 'sold_to', 'unit', 'unit__vin')

    def VIN(self, obj):
        return obj.unit.vin

如果需要自定义过滤项的显示名称，可以给unit模型的vin字段设置verbose_name="VIN"，或者自定义SimpleListFilter类实现更复杂的过滤逻辑。

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