django-smart-selects链式下拉查询集过滤问题求助

问题根源 #

django-smart-selects的ChainedForeignKey会自动生成对应的表单字段逻辑，直接覆盖了你在表单__init__方法中修改queryset的操作，导致常规过滤失效。

可行解决方案 #

方案1：自定义过滤后的ChainedModelChoiceField #

直接继承smart-selects的字段，重写queryset获取逻辑，强制过滤status=True的AvailableHours：

# forms.py
from django import forms
from smart_selects.form_fields import ChainedModelChoiceField
from .models import YourBookingModel, AvailableHours

class FilteredChainedTimeField(ChainedModelChoiceField):
    def get_queryset(self):
        # 先获取父类生成的基础queryset，再追加status过滤
        base_qs = super().get_queryset()
        return base_qs.filter(status=True)

class BookingForm(forms.ModelForm):
    booked_time = FilteredChainedTimeField(
        chained_field="service",  # 替换为你模型中ChainedForeignKey的chained_field参数值
        chained_model_field="service",  # 替换为关联模型的对应字段名
        model=AvailableHours,
        show_all=False,
        auto_choose=False,
    )

    class Meta:
        model = YourBookingModel
        fields = ["service", "booked_time"]  # 按需调整字段

方案2：给AvailableHours添加自定义管理器 #

如果业务上大部分场景只需要status=True的可用时段，给模型设置默认管理器，从根源上限制查询范围：

# models.py
from django.db import models
from smart_selects.db_fields import ChainedForeignKey

class AvailableHoursManager(models.Manager):
    def get_queryset(self):
        return super().get_queryset().filter(status=True)

class AvailableHours(models.Model):
    service = models.ForeignKey(Service, on_delete=models.CASCADE)
    time_slot = models.TimeField()
    status = models.BooleanField(default=True)

    # 默认只返回启用的时段
    objects = AvailableHoursManager()
    # 保留原始管理器，用于需要查询所有时段的场景
    all_objects = models.Manager()

# 你的Booking模型示例
class Booking(models.Model):
    service = models.ForeignKey(Service, on_delete=models.CASCADE)
    booked_time = ChainedForeignKey(
        AvailableHours,
        chained_field="service",
        chained_model_field="service",
        on_delete=models.CASCADE,
    )

这样smart-selects在生成选项时会自动使用默认管理器，只加载status=True的记录。

方案3：Admin后台单独处理 #

如果仅Admin页面有需求，可在Admin类中重写字段生成逻辑：

# admin.py
from django.contrib import admin
from smart_selects.form_fields import ChainedModelChoiceField
from .models import Booking

class BookingAdmin(admin.ModelAdmin):
    def formfield_for_dbfield(self, db_field, request, **kwargs):
        field = super().formfield_for_dbfield(db_field, request, **kwargs)
        if db_field.name == "booked_time" and isinstance(field, ChainedModelChoiceField):
            field.queryset = field.queryset.filter(status=True)
        return field

admin.site.register(Booking, BookingAdmin)

方案4：重写smart-selects的AJAX视图（不推荐） #

smart-selects通过AJAX请求动态加载选项，可重写其核心视图实现过滤，但该方法依赖包内部实现，升级可能失效：

# urls.py
from django.urls import path
from smart_selects.views import chained_filter
from .models import AvailableHours

class FilteredChainedView(chained_filter):
    def get_queryset(self):
        qs = super().get_queryset()
        if self.model == AvailableHours:
            qs = qs.filter(status=True)
        return qs

urlpatterns = [
    # 替换原smart-selects的路由
    path("chained_filter/", FilteredChainedView.as_view(), name="chained_filter"),
    # ...其他路由
]

推荐优先级 #

优先选择方案1或方案2，前者灵活可控，后者从模型层统一逻辑；Admin专属场景用方案3；方案4仅作为临时应急方案。

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