Shopware Store API中如何结合Associations与Includes仅获取子变体的指定字段

这个问题我之前也碰到过！核心难点在于父产品和子变体的API别名都是product，直接用顶层includes会同时影响两者的返回字段。不过Shopware的API支持在关联配置内部单独设置includes，刚好可以解决这个问题。

正确的请求配置 #

你只需要在associations.children里添加专属的includes，用来控制子变体的返回字段，同时顶层的includes专门定义父产品需要保留的字段。具体配置如下：

{
  "page": 1,
  "limit": 100,
  "filter": [
    {
      "type": "equals",
      "field": "product.parentId",
      "value": null
    }
  ],
  "associations": {
    "children": {
      "associations": {
        "options": {}
      },
      // 单独控制子变体的返回字段
      "includes": {
        "product": ["stock", "options"]
      }
    },
    "properties": {
      "associations": {
        "group": {}
      }
    }
  },
  // 定义父产品需要的所有字段，按需添加
  "includes": {
    "product": ["id", "name", "price", "images", "description", "properties"]
  },
  "total-count-mode": 1
}

关键逻辑说明 #

1. 嵌套的includes优先级更高：在children关联内部的includes只会作用于该关联返回的子变体数据，不会影响顶层的父产品。
2. 顶层includes专注父产品：你可以在这里列出父产品需要的所有字段（比如名称、价格、图片等），确保父产品的完整数据不丢失。
3. 子变体仅返回指定字段：通过children.includes.product指定stock和options，子变体就只会返回这两个字段以及关联的options数据，多余的价格、图片等信息会被过滤掉。

这种写法完美区分了父产品和子变体的返回字段需求，也是Shopware API处理同类型不同层级资源的标准方式。

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