Shopware 6自定义CLI商品导入插件：关联媒体与设置封面ID

核心问题澄清 #

你提到的product_media表是商品与媒体的关联中间表，用于存储商品和多个媒体文件的关联关系，但封面ID实际存储在product表的cover_id字段中，指向media表的主键ID，而非product_media的ID。

分步实现方案 #

1. 保留媒体导入后的映射关系 #

在Media Importer完成图片上传后，必须生成并保存一个媒体标识（如CSV中的文件名）与media_id的映射表（可用数组或临时存储）。因为CSV里的"Media"和"Cover"字段一般是文件名而非直接ID，需要通过这个映射把标识转换成对应的media_id。

2. 修正Product Mapper配置 #

当前配置无法正确识别关联字段，调整为符合Shopware数据结构的格式：

{
  "product": {
    "productNumber": "Product Number",
    "name": "Name",
    "active": {
      "key": "Active",
      "type": "bool"
    },
    "media": {
      "type": "association",
      "map": [
        {
          "mediaId": "Media"
        }
      ]
    },
    "cover": {
      "type": "association",
      "map": {
        "mediaId": "Cover"
      }
    },
    "description": "Description",
    "stock": {
      "key": "Stock",
      "type": "int"
    }
  }
}

• 添加"type": "association"声明字段为关联类型
• media字段用数组格式，支持关联多个媒体文件

3. 在ProductService中处理媒体ID映射 #

在setProduct方法中，先将CSV行里的媒体标识转换成media_id，再传入创建/更新逻辑：

public function setProduct(array $row, Context $context): void
{
    try {
        // 从Media Importer的映射表中匹配对应media_id
        $mediaKey = $row['Media'] ?? '';
        $coverKey = $row['Cover'] ?? '';
        
        if ($mediaKey && isset($this->mediaIdMap[$mediaKey])) {
            $row['media'] = [['mediaId' => $this->mediaIdMap[$mediaKey]]];
        }
        if ($coverKey && isset($this->mediaIdMap[$coverKey])) {
            $row['cover'] = ['mediaId' => $this->mediaIdMap[$coverKey]];
        }

        $productId = $this->getId('productNumber', $row['productNumber'], $context);
        if ($productId) {
            $row['id'] = $productId;
            $this->update($row, $context);
        } else {
            $this->create($row, $context);
        }
    } catch (Throwable $throwable) {
        throw $throwable;
    }
}

• $this->mediaIdMap是你在Media Importer中生成的[媒体标识 => media_id]映射数组
• 注意Shopware的格式要求：多个媒体需用嵌套数组，封面是单个关联对象

4. 商品更新时的媒体覆盖（可选） #

默认情况下Shopware更新商品时会追加媒体而非替换，若需要覆盖现有关联，可在更新前清空旧关联：

if ($productId) {
    // 先删除现有商品媒体关联
    $productRepository = $this->container->get('product.repository');
    $productRepository->update([
        [
            'id' => $productId,
            'media' => null
        ]
    ], $context);
    
    $row['id'] = $productId;
    $this->update($row, $context);
}

关键注意事项 #

• 导入媒体时必须使用商品媒体文件夹的ID，否则媒体无法正确关联到商品
• 封面的media_id必须是已关联到该商品的媒体ID（即存在于product_media表中），否则设置会失败
• 批量导入时建议批量处理媒体映射，避免循环中重复查询数据库

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