无头Shopware中自动切换物流服务商的实现问题求助

问题背景 #

在无头Shopware场景中，需实现当前物流服务商因规则限制不可用时自动切换至可用服务商的功能。已知Storefront侧的现有改动因核心平台代码未同步，无法适配无头模式。尝试通过开发插件监听CartChangedEvent实现，但遇到以下问题：

• /store-api/checkout/cart接口返回旧的物流服务商信息
• 调试确认后端上下文已更新，但推测CartChangedEvent回调触发时机晚于cart变更响应的生成

现有插件代码 #

class CartUpdateSubscriber implements EventSubscriberInterface
{
    private $shippingMethodRepository;
    private $contextSwitcher; // 补充遗漏的类属性

    public function __construct(
        SalesChannelContextSwitcher $contextSwitcher,
        SalesChannelRepositoryInterface $shippingMethodRepository
    ) {
        $this->contextSwitcher = $contextSwitcher;
        $this->shippingMethodRepository = $shippingMethodRepository;
    }

    /**
     * 注册监听事件
     *
     * @return array
     */
    public static function getSubscribedEvents(): array
    {
        return [
            CartChangedEvent::class => 'onCartChange',
        ];
    }

    /**
     * @param CartChangedEvent $event
     * @return void
     */
    public function onCartChange(CartChangedEvent $event): void
    {
        $dataBag = new DataBag([
            'shippingMethodId' => $this->getShippingMethod($event->getContext())->getId(),
        ]);
        $this->contextSwitcher->update($dataBag, $event->getContext());
    }

    private function getShippingMethod(SalesChannelContext $context): ShippingMethodEntity
    {
        $criteria = new Criteria();
        $criteria->addFilter(new EqualsFilter('active', true));

        $allShipments = $this->shippingMethodRepository->search($criteria, $context)->getEntities();

        $availableShippingMethods = $allShipments->filterByActiveRules($context);

        $shippingMethod = $availableShippingMethods->filterByProperty('name', "Spedition");
        if($availableShippingMethods->count() >= 2){
            $shippingMethod = $availableShippingMethods->filterByProperty('name',"Express");
        }

        return $shippingMethod->first();
    }
}

代码优化方案（解决事件时机问题） #

1. 更换监听事件
   放弃CartChangedEvent，改用CartBeforePersistedEvent或CartLoadedEvent：

   • CartBeforePersistedEvent在cart持久化前触发，此时修改上下文能同步到最终响应
   • CartLoadedEvent在cart从数据库加载后触发，适合在每次获取cart时校验并切换物流商
     修改事件注册：

   public static function getSubscribedEvents(): array
   {
       return [
           CartBeforePersistedEvent::class => 'onCartBeforePersist',
           CartLoadedEvent::class => 'onCartLoaded', // 可选，覆盖cart加载场景
       ];
   }
   

2. 同时更新Cart与上下文
   仅更新SalesChannelContext可能无法同步到cart的响应数据，需同时更新cart中的shipping method：

   public function onCartBeforePersist(CartBeforePersistedEvent $event): void
   {
       $context = $event->getContext();
       $cart = $event->getCart();
       
       $newShippingMethod = $this->getShippingMethod($context);
       if (!$newShippingMethod) {
           return;
       }
   
       // 更新上下文
       $dataBag = new DataBag(['shippingMethodId' => $newShippingMethod->getId()]);
       $this->contextSwitcher->update($dataBag, $context);
   
       // 更新cart中的shipping method
       $cart->setShippingMethod($newShippingMethod);
   }
   

3. 优化物流商筛选逻辑
   原代码依赖名称硬编码筛选，建议改用ID或自定义属性，避免名称变更导致失效：

   // 示例：通过自定义属性筛选默认物流商
   $shippingMethod = $availableShippingMethods->filter(function(ShippingMethodEntity $method) {
       return $method->getCustomFields()['is_default_spedition'] ?? false;
   });
   

其他插件实现思路 #

1. 自定义Store API端点
   创建/store-api/checkout/shipping-method/auto-switch端点，前端调用cart接口后主动触发该接口同步物流商，确保数据一致性。

2. 扩展规则引擎拦截物流商列表
   利用ShippingMethodAvailableFilterEvent拦截物流商列表，自动选中第一个符合规则的可用选项，无需依赖cart变更事件。

3. 订单创建前二次校验
   在OrderBeforeSaveEvent中再次校验物流商可用性，避免因上下文变更不及时导致订单使用不可用物流商。

无头侧实现建议 #

如果后端插件存在时机问题，可在无头侧（前端）实现以下逻辑：

• 调用/store-api/shipping-method获取所有可用物流商
• 对比当前cart中的物流商是否在可用列表中，若不在则自动切换到第一个可用选项
• 调用/store-api/checkout/cart/change-shipping-method更新cart

这种方式直接控制切换时机，无需依赖后端事件顺序，但需要前端额外处理逻辑。

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