Django+Graphene中django-filter多值关联过滤异常排查

在Django中用Graphene构建GraphQL Schema时，尝试通过外键关联的Software名称列表过滤Product数据。单值（如"Blender"）过滤正常，但传入逗号分隔的字符串"Blender,Houdini"时返回空结果。Django Shell中用列表["Blender", "Houdini"]查询能得到正确结果，Debug Toolbar显示异常SQL把参数当成了单个值('Blender,Houdini')，而非两个独立值。

问题原因 #

核心问题是GraphQL参数类型不匹配：

• 你定义的CharInFilter对应Django的__in查询，本质需要接收列表类型的参数
• 但你传入的是逗号分隔的单个字符串，Graphene会把它当作单一值传递给过滤器，导致SQL里变成IN ('Blender,Houdini')，自然查不到匹配数据

解决步骤 #

1. 直接传入列表类型参数 #

Graphene-Django的InFilter默认会生成列表类型的参数，不需要手动处理逗号分割，直接在查询里传列表即可。

2. 修改GraphQL查询语句 #

把参数从单个字符串改成列表格式：

query authorPageProducts {
  user(slug: "john") {
    productSet(softwares_Name: ["Blender", "Houdini"]) {
      edges {
        node {
          name
          softwares {
            name
          }
        }
      }
    }
  }
}

3. 过滤器配置无需修改 #

你的CharInFilter配置是正确的，保持原样即可：

class CharInFilter(BaseInFilter, CharFilter):
    pass

class ProductFilter(FilterSet):
    softwares__name = CharInFilter(field_name="softwares__name", lookup_expr="in")

    class Meta:
        model = Product
        fields = {"name": ["exact", "icontains"]}

4. 验证修正后的SQL #

此时生成的SQL会正确解析为两个独立值，查询结果正常：

SELECT COUNT(*) AS "__count"
  FROM "shop_product"
 INNER JOIN "shop_product_softwares"
    ON ("shop_product"."id" = "shop_product_softwares"."product_id")
 INNER JOIN "shop_software"
    ON ("shop_product_softwares"."software_id" = "shop_software"."id")
 WHERE ("shop_product"."author_id" = 2 AND "shop_software"."name" IN ('Blender', 'Houdini'))

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