Shopware 6 API获取指定分类树时关联过滤条件未生效问题排查

我明白你遇到的困扰了——你原本希望通过API只返回父分类是一级分类「Construction」的二级分类「Doorframe」，但结果却多出了一个父分类为「Doorframe」的二级分类，核心问题出在你对Shopware 6 API中关联过滤参数的作用理解偏差上。

为什么当前查询不生效？ #

你在associations.parent.filter里设置的条件，并不是用来筛选主分类实体的，它的作用仅仅是：当加载主分类的parent关联数据时，只返回符合该过滤条件的父分类。具体逻辑是：

1. 主查询先根据你设置的主filter（level=2且name=Doorframe），找出所有符合条件的二级分类——这其中自然包含了父分类是「Doorframe」的那个二级分类；
2. 然后对每个返回的主分类，加载它们的parent关联数据时，只会保留符合level=1且name=Construction的父分类；对于父分类不符合的主分类，它的parent字段会是空值，但主分类本身依然会留在结果列表里。

这就是为什么你会得到两个结果的根本原因。

正确的查询方式：在主过滤条件中关联父分类属性 #

要实现「只返回父分类是一级「Construction」的二级「Doorframe」」的需求，你需要把针对父分类的过滤条件加到主查询的filter里，通过点语法直接关联父分类的字段。修改后的完整查询JSON如下：

{
  "page": 1,
  "limit": 5,
  "filter": [
    {
      "type": "multi",
      "operator": "and",
      "queries": [
        {
          "type": "equals",
          "field": "level",
          "value": 2
        },
        {
          "type": "equals",
          "field": "name",
          "value": "Doorframe"
        },
        {
          "type": "equals",
          "field": "parent.level",
          "value": 1
        },
        {
          "type": "equals",
          "field": "parent.name",
          "value": "Construction"
        }
      ]
    }
  ],
  "sort": [],
  "post-filter": [],
  "associations": {
    "parent": {
      "limit": 2,
      "fields": ["id", "name", "level"]
    }
  },
  "aggregations": [],
  "grouping": [],
  "includes": [],
  "fields": [],
  "total-count-mode": true
}

关键修改点说明： #

1. 主过滤条件新增父分类规则：在主filter的multi查询里，加入了针对parent.level和parent.name的判断，这样主查询会直接排除那些父分类不符合条件的二级分类；
2. 简化关联配置：associations.parent里只保留了必要的字段配置（可选），用来返回符合条件的父分类数据，不需要再在这里设置过滤条件——因为主查询已经把不符合的主分类过滤掉了。

这样修改后，你就能得到唯一符合预期的结果：父分类是「Construction」的二级「Doorframe」分类。

备注：内容来源于stack exchange，提问作者Daniel W.