克隆Shopware 6分类树时修复排序顺序问题

问题核心 #

克隆包含子分类的分类时，子分类的afterCategoryId会直接复制源分类的对应值，导致指向源分类的兄弟实体而非克隆后的子分类，最终排序混乱。前端behavior.overwrites无法递归作用于子分类，直接在VersionManager中置空afterCategoryId又会完全丢失排序逻辑。

最优解决方案：利用EntityCloningEvent在持久化前修正 #

Shopware提供了\Shopware\Core\Framework\DataAbstractionLayer\Event\EntityCloningEvent，这个事件会在实体克隆过程中、数据持久化前触发，完美适配需求——既可以修正子分类的afterCategoryId，又能保留原有排序逻辑。

实现步骤

1. 创建事件订阅类，监听EntityCloningEvent，仅处理分类实体的克隆操作
2. 在事件处理中，建立源子分类与克隆后子分类的ID映射
3. 将克隆子分类的afterCategoryId替换为对应克隆后的子分类ID，确保排序继承源分类的结构

代码示例

<?php

namespace YourPluginNamespace\Subscriber;

use Shopware\Core\Content\Category\CategoryDefinition;
use Shopware\Core\Framework\DataAbstractionLayer\Event\EntityCloningEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class CategoryCloneSortingFixSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            EntityCloningEvent::class => 'onCategoryCloning',
        ];
    }

    public function onCategoryCloning(EntityCloningEvent $event): void
    {
        // 仅处理分类实体的克隆事件
        if ($event->getDefinition()->getEntityName() !== CategoryDefinition::ENTITY_NAME) {
            return;
        }

        $clonedCategory = $event->getClonedEntity();
        $sourceCategory = $event->getSourceEntity();

        // 无子分类则直接返回
        if (empty($clonedCategory['children']) || empty($sourceCategory['children'])) {
            return;
        }

        // 建立源子分类ID → 克隆后子分类ID的映射
        $sourceToCloneChildMap = [];
        $clonedChildIds = [];
        foreach ($sourceCategory['children'] as $index => $sourceChild) {
            $clonedChild = $clonedCategory['children'][$index] ?? null;
            if (!$clonedChild) {
                continue;
            }
            $sourceToCloneChildMap[$sourceChild['id']] = $clonedChild['id'];
            $clonedChildIds[] = $clonedChild['id'];
        }

        // 修正克隆子分类的afterCategoryId
        foreach ($clonedCategory['children'] as $index => &$clonedChild) {
            $originalAfterId = $clonedChild['afterCategoryId'] ?? null;
            
            // 如果原afterCategoryId对应源分类的子分类，替换为克隆后的ID
            if ($originalAfterId && isset($sourceToCloneChildMap[$originalAfterId])) {
                $clonedChild['afterCategoryId'] = $sourceToCloneChildMap[$originalAfterId];
                continue;
            }

            // 若原afterId指向外部分类，按源排序设置为前一个克隆子分类的ID
            $clonedChild['afterCategoryId'] = $index > 0 ? $clonedChildIds[$index - 1] : null;
        }
    }
}

代码说明

• 仅监听分类实体的克隆事件，避免影响其他实体
• 通过映射关系将源子分类的afterCategoryId转换为克隆后对应子分类的ID，确保排序逻辑与源分类完全一致
• 对指向外部分类的afterCategoryId做兼容处理，按源排序顺序设置为相邻的克隆子分类ID

为什么不推荐事后修正？ #

如果使用EntityWrittenContainerEvent，需要在数据持久化后再次查询并更新分类，会多一次数据库操作，且可能出现短暂的数据不一致（克隆后到修正前的窗口）。而EntityCloningEvent在克隆流程内处理，逻辑更闭环，性能更优。

前端代码补充说明 #

你当前的前端代码中，behavior.overwrites仅作用于父分类，Shopware的默认克隆逻辑不会将overwrites递归应用到子实体，因此子分类的修正必须在后端完成。

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