Django ORM多Filter方法执行时重复JOIN问题解决

问题根源 #

你当前的实现中，每个筛选器方法（filter_by_dos_from和filter_by_dos_to）都单独触发了一次base_icd__chart_review_dos的关联查询，Django ORM会为每个独立的filter()调用创建新的JOIN，导致最终SQL出现重复关联表的情况。

解决方案 #

方案1：直接使用字段路径替代自定义方法（推荐） #

不需要自定义筛选方法，直接通过field_name指定关联字段路径，让Django-filter自动合并条件，复用同一次JOIN：

class Icd10Filter(filters.FilterSet):
    # 直接指定关联字段路径，无需自定义方法
    dosFrom = filters.DateFilter(field_name='base_icd__chart_review_dos__dos_from', lookup_expr='gte')
    dosTo = filters.DateFilter(field_name='base_icd__chart_review_dos__dos_to', lookup_expr='lte')

    class Meta:
        model = risk_adjustment.Icd10  # 关联目标ICD10模型
        fields = ['dosFrom', 'dosTo']

方案2：使用范围筛选器简化代码 #

如果你的Django-filter版本支持，可以用DateRangeFilter直接处理日期范围，进一步简化：

from django_filters import DateRangeFilter

class Icd10Filter(filters.FilterSet):
    dos_range = DateRangeFilter(field_name='base_icd__chart_review_dos__dos_from')
    # 若需精确匹配from/to，也可使用RangeFilter
    # dos_range = filters.RangeFilter(field_name='base_icd__chart_review_dos__dos_from')

    class Meta:
        model = risk_adjustment.Icd10
        fields = ['dos_range']

方案3：自定义单一方法处理双条件（适用于复杂逻辑场景） #

如果必须保留自定义方法逻辑，可以将两个筛选条件合并到同一个方法中，确保关联路径复用：

class Icd10Filter(filters.FilterSet):
    dosFrom = filters.DateFilter(method='filter_by_dos_range')
    dosTo = filters.DateFilter(method='filter_by_dos_range')

    def filter_by_dos_range(self, queryset, name, value):
        # 根据参数名判断筛选类型，合并条件
        if name == 'dosFrom':
            return queryset.filter(base_icd__chart_review_dos__dos_from__gte=value)
        elif name == 'dosTo':
            return queryset.filter(base_icd__chart_review_dos__dos_to__lte=value)
        return queryset

效果验证 #

修改后，同时使用两个筛选器时，生成的SQL会复用同一个base_icd__chart_review_dos关联，不会出现冗余JOIN，最终SQL结构与你预期的一致。

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