产品streams在部分动态产品组属性规则下返回空集合问题

问题现象 #

• 已实现EntityRepositoryInterface、SalesChannelRepositoryInterface两个类的装饰器，在二者的search方法中添加->addAssociation('streams')代码，实现产品动态产品组（streams）的自动加载，支持店面访问动态产品组
• 规则匹配表现差异：
  • 正常场景：选择指定产品、使用productNumber equals number规则、按指定分类筛选规则时，stream匹配返回结果正常，无null值
  • 异常场景：基于属性值筛选产品时始终返回空集合；已配置属性继承的带变体产品，可在产品组Preview页面正常展示，但店面自动加载时匹配失败
• 初步排查结论：异常与变体属性、继承类产品数据的处理逻辑相关

根因 #

直接添加单层streams关联时，缺少stream属性匹配所需的关联数据加载，且销售渠道层未触发变体属性的继承解析逻辑：

• 产品组属性规则匹配依赖产品的options、properties及对应分组、可见性关联数据，单层关联streams时不会加载这些依赖数据，属性匹配阶段拿不到有效属性值，直接判定为不匹配
• 销售渠道上下文中默认未强制开启变体属性继承检测时，自动加载streams的流程不会读取变体从主产品继承的属性值，导致属性校验为空
• 产品组Preview页面走专用匹配逻辑，会提前加载全量依赖关联、开启继承检测，因此预览正常，和店面自动加载的逻辑链路不一致

修复步骤 #

1. 补全关联加载层级，不要仅加载streams单层关联，需同步加载匹配所需的关联数据：

// 两个装饰器的criteria配置中补充以下关联
$criteria->addAssociation('streams.filters');
$criteria->addAssociation('options.group');
$criteria->addAssociation('properties.group');

2. 仅在SalesChannelRepositoryInterface的装饰器中，执行search前开启继承检测，避免全局开启影响后台性能：

$salesChannelContext->getContext()->setConsiderInheritance(true);

注意：setConsiderInheritance(true)仅可在销售渠道层的装饰器中添加，全局EntityRepository层开启会大幅增加后台管理页的查询开销，影响性能
3. 针对6.4及以上版本，补充属性可见性关联加载，过滤当前销售渠道不可见的属性，避免匹配逻辑被可见性校验拦截：

$criteria->addAssociation('properties.visibility');
$criteria->addAssociation('options.visibility');

4. 完成代码调整后清空项目缓存，重新测试属性筛选场景，即可正常返回匹配的stream集合。

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