Django admin用smart-select实现层级联动下拉菜单报错求解

核心错误点 #

• chained_model_field参数配置错误：该参数需要填写目标关联模型中对应上层模型的字段名，你的配置中填写的是当前Institution模型的字段名，和实际关联字段不匹配
• 字段类型不兼容：ChainedForeignKey仅支持和单值字段（普通外键、单选字段）联动，你上层nace_sections是多值ManyToManyField，类型不匹配导致联动失效
• 数据库未同步：报错Invalid column name 'nace_divisions_id'是因为新增ChainedForeignKey字段后未执行迁移操作，数据库未生成对应字段
• 可选遗漏配置：未在项目中完成smart_selects的基础注册配置，导致静态资源和联动路由失效

修复步骤 #

1. 修正基础模型命名冲突 #

首先调整基础层级模型的related_name，避免和字段本身重名引发后续查询问题：

# models.py
class NaceSection(models.Model):
    code = models.CharField(max_length=1, unique=True)
    description_english = models.CharField(max_length=500)


class NaceDivision(models.Model):
    code = models.CharField(max_length=2, unique=True)
    # related_name改为反向查询用的语义化名称，不和字段本身重名
    nace_section = models.ForeignKey(NaceSection, on_delete=models.CASCADE, related_name="divisions")
    description_english = models.CharField(max_length=500)


class NaceGroup(models.Model):
    nace_division = models.ForeignKey(NaceDivision, on_delete=models.CASCADE, related_name="groups")
    code = models.CharField(max_length=4, unique=True)
    description_english = models.CharField(max_length=500)

2. 按业务需求修正Institution模型配置 #

场景1：单选型逻辑（一个机构仅对应一个层级节点）

如果不需要多选层级，把上层字段改为普通外键，用ChainedForeignKey实现联动：

# models.py
from smart_selects.db_fields import ChainedForeignKey

class Institution(models.Model):
    # 单选Section，改用普通外键
    nace_section = models.ForeignKey(NaceSection, on_delete=models.SET_NULL, null=True, blank=True)
    nace_division = ChainedForeignKey(
        NaceDivision,
        chained_field="nace_section", # 当前模型中关联上层的字段名
        chained_model_field="nace_section", # NaceDivision模型中关联NaceSection的字段名
        blank=True,
        null=True
    )
    nace_group = ChainedForeignKey(
        NaceGroup,
        chained_field="nace_division", # 当前模型中关联上层的字段名
        chained_model_field="nace_division", # NaceGroup模型中关联NaceDivision的字段名
        blank=True,
        null=True
    )

场景2：多选型逻辑（一个机构可对应多个层级节点）

如果需要多选层级，所有字段统一用ChainedManyToManyField：

# models.py
from smart_selects.db_fields import ChainedManyToManyField

class Institution(models.Model):
    nace_sections = models.ManyToManyField(NaceSection, related_name="institutions", blank=True)
    nace_divisions = ChainedManyToManyField(
        NaceDivision,
        chained_field="nace_sections",
        chained_model_field="nace_section", # 填写NaceDivision中关联NaceSection的字段名
        blank=True
    )
    nace_groups = ChainedManyToManyField(
        NaceGroup,
        chained_field="nace_divisions",
        chained_model_field="nace_division", # 填写NaceGroup中关联NaceDivision的字段名
        blank=True
    )

3. 完成smart_selects基础配置 #

在settings.py中注册应用并配置依赖：

INSTALLED_APPS = [
    # ... 其他原有应用
    'smart_selects',
]

# Django 3.0+版本需要加这行配置，保证jQuery正常加载
USE_DJANGO_JQUERY = True

在项目根urls.py中添加联动路由：

urlpatterns = [
    # ... 其他原有路由
    path('chaining/', include('smart_selects.urls')),
]

4. 同步数据库结构 #

执行迁移命令生成对应字段：

python manage.py makemigrations
python manage.py migrate

完成以上操作后重启服务即可在admin后台看到层级联动效果。

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