Django Admin配置Client模型遇字段错误及显示异常求助

第一步：检查Client模型的字段定义 #

先确认models.py里的Client模型确实包含client_name、client_value字段，且字段的editable属性未设为False（默认值为True）。示例正确的模型定义：

from django.db import models

class Client(models.Model):
    client_key = models.ForeignKey(SomeRelatedModel, on_delete=models.CASCADE)
    client_name = models.CharField(max_length=100)
    client_value = models.CharField(max_length=200)

    def __str__(self):
        return self.client_name

如果字段是通过继承父模型得到的，需确认父模型的字段可正常继承且未被限制编辑。

第二步：修正Admin类的配置 #

打开admin.py，确保Client对应的Admin类显式指定了要显示的所有字段，不要遗漏client_name和client_value：

错误配置（会导致字段不显示）： #

from django.contrib import admin
from .models import Client

@admin.register(Client)
class ClientDataAdmin(admin.ModelAdmin):
    fields = ['client_key']  # 仅包含client_key，遗漏目标字段

正确配置： #

from django.contrib import admin
from .models import Client

@admin.register(Client)
class ClientDataAdmin(admin.ModelAdmin):
    # 直接指定所有需显示的字段
    fields = ['client_key', 'client_name', 'client_value']
    
    # 也可按分组方式配置（可选）
    # fieldsets = (
    #     (None, {
    #         'fields': ('client_key', 'client_name', 'client_value')
    #     }),
    # )

若之前使用了exclude属性，需确认未排除这两个字段；若使用readonly_fields，需同时将字段加入fields或fieldsets中，否则只读字段也不会显示。

第三步：排查FieldError残留问题 #

之前出现的FieldError大概率是因为Admin类中引用了错误的字段名（比如拼写错误），调整时可能误将正确字段从配置中删除，导致现在仅显示client_key。重新核对字段名拼写，确保Admin配置与模型字段完全匹配。

第四步：刷新缓存并重启服务 #

Django的缓存或浏览器缓存可能导致页面未更新，执行以下操作：

• 重启Django开发服务器
• 清除浏览器缓存（或使用无痕模式打开Admin页面）

第五步：检查模型Meta类设置 #

确认Client模型的Meta类未设置exclude属性限制字段显示：

class Client(models.Model):
    # ... 字段定义 ...
    class Meta:
        exclude = ['client_name', 'client_value']  # 此配置会导致Admin默认隐藏这些字段

若存在该配置，要么删除exclude，要么在Admin类中显式通过fields指定包含这两个字段。

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