Magento 2：为可配置商品的同类型关联商品复用同一图片

我完全懂你这个痛点——批量创建可配置商品的关联简单商品时，Magento默认会重复复制同一张图片，既占存储空间又浪费资源。下面是我实战过的解决方案，能让同类型（比如同色不同码）的简单商品共用同一张图片，彻底避免重复复制：

问题根源在于你的脚本可能为每个简单商品单独执行了图片上传/添加逻辑，触发了Magento的文件复制机制。我们要做的是只上传一次图片，然后将这个已存在的图片资源关联给所有同类型的简单商品。

1. 先上传一次图片，获取共享的媒体资源条目 #

首先，将目标图片上传到Magento媒体库，得到对应的媒体条目对象，后续所有同类型商品都复用这个条目：

// 注入或获取Gallery Processor实例
/** @var \Magento\Catalog\Model\Product\Gallery\Processor $galleryProcessor */
$galleryProcessor = $this->objectManager->get(\Magento\Catalog\Model\Product\Gallery\Processor::class);

// 图片的本地路径或媒体库路径（示例：pub/media下的路径）
$targetImagePath = 'path/to/your/black_shirt.jpg';

// 创建第一个同类型简单商品（比如黑色S码）
$firstSimpleProduct = $this->createSimpleProduct('Black', 'S'); // 你的创建商品方法

// 上传图片到这个商品，关键是最后一个参数设为false（不复制，直接关联）
$galleryProcessor->addImage(
    $firstSimpleProduct,
    $targetImagePath,
    ['image', 'small_image', 'thumbnail'], // 设置图片类型
    false, // 禁用缓存生成（按需开启）
    false  // 不复制文件，直接使用原文件
);
$firstSimpleProduct->save();

// 获取刚上传的共享图片条目
$mediaEntries = $firstSimpleProduct->getMediaGalleryEntries();
$sharedImageEntry = reset($mediaEntries); // 取第一个条目即我们需要的共享图片

2. 为同类型其他商品关联共享图片 #

接下来，创建同类型的其他简单商品时，直接把上面拿到的sharedImageEntry添加到它们的媒体库中，不用再重复上传：

// 循环处理同颜色的不同尺码商品
$sizeList = ['M', 'L', 'XL'];
foreach ($sizeList as $size) {
    // 创建当前尺码的简单商品
    $simpleProduct = $this->createSimpleProduct('Black', $size);
    
    // 获取当前商品的媒体条目列表，添加共享图片条目
    $currentEntries = $simpleProduct->getMediaGalleryEntries() ?: [];
    $currentEntries[] = $sharedImageEntry;
    
    // 设置商品的图片类型和媒体条目
    $simpleProduct->setMediaGalleryEntries($currentEntries);
    $simpleProduct->setImage($sharedImageEntry->getFile());
    $simpleProduct->setSmallImage($sharedImageEntry->getFile());
    $simpleProduct->setThumbnail($sharedImageEntry->getFile());
    
    $simpleProduct->save();
}

3. 关键注意事项 #

• 确保图片文件已经存在于Magento的媒体目录（pub/media/catalog/product/...）中，否则第一次上传时还是会触发复制。如果是本地文件，第一次上传可以把addImage的最后一个参数设为true，直接移动文件到媒体库，减少一次复制操作。
• 媒体条目对象的file属性是图片在媒体库中的相对路径，多个商品共享这个路径就不会生成新的文件副本。
• 如果你的脚本是用API方式创建商品，逻辑类似：先上传图片获取entry_id，然后在创建其他商品时关联这个entry_id即可。

简化方案：直接关联已有媒体路径 #

如果你已经知道图片在媒体库的相对路径（比如b/l/black_shirt.jpg），可以跳过上传步骤，直接为商品设置图片路径：

$imageRelativePath = 'b/l/black_shirt.jpg';

// 创建媒体条目对象
$mediaEntry = $this->objectManager->create(\Magento\Catalog\Api\Data\ProductAttributeMediaEntryInterface::class);
$mediaEntry->setFile($imageRelativePath);
$mediaEntry->setMediaType(\Magento\Catalog\Model\Product\Media\Config::MEDIA_TYPE_IMAGE);
$mediaEntry->setDisabled(false);
$mediaEntry->setLabel('Black Shirt');
$mediaEntry->setPosition(1);
$mediaEntry->setTypes(['image', 'small_image', 'thumbnail']);

// 为商品设置图片
$simpleProduct->setMediaGalleryEntries([$mediaEntry]);
$simpleProduct->setImage($imageRelativePath);
$simpleProduct->setSmallImage($imageRelativePath);
$simpleProduct->setThumbnail($imageRelativePath);

$simpleProduct->save();

这样所有同类型商品都会指向同一个图片文件，完全不会产生重复副本。

内容的提问来源于stack exchange，提问作者Abhijeet kumar sharma