Magento 2 程序化创建商品时出现URL键重复错误求助

这个问题我之前踩过一模一样的坑！你只检查了SKU是否重复，但Magento创建商品时会自动基于商品名称生成URL key（默认转成小写、空格替换成连字符），如果已有商品用了相同的URL key（哪怕SKU完全不同），就会抛出这个错误。下面给你两种实用的解决思路：

思路1：手动生成并检查唯一URL key #

这种方式适合需要完全自定义URL key规则的场景，核心是先基于名称生成基础URL key，然后循环检查是否已存在，存在就加后缀（比如-1、-2）：

修改后的代码示例 #

$sku = $row[0]; 
$name = $row[1]; 
$product = $this->productFactory->create(); // 确保已注入ProductFactory依赖
$existingProductId = $product->getIdBySku($sku); 

if($existingProductId) { 
    echo 'Product with SKU '.$sku.' already exists'; 
} else { 
    $product->setSku($sku); 
    $product->setName($name); 

    // 1. 生成规范的基础URL key
    $baseUrlKey = strtolower(preg_replace('/[^a-zA-Z0-9]/', '-', trim($name)));
    $baseUrlKey = preg_replace('/-+/', '-', $baseUrlKey); // 替换多个连字符为单个
    $urlKey = $baseUrlKey;
    $counter = 1;

    // 2. 循环检查URL key是否已存在当前店铺中
    while ($this->isUrlKeyDuplicate($urlKey)) {
        $urlKey = $baseUrlKey . '-' . $counter;
        $counter++;
    }

    // 3. 设置唯一URL key
    $product->setUrlKey($urlKey);

    // 继续设置其他商品属性（价格、库存等）
    // $product->setPrice(99.99);
    // ...

    try {
        $product->save();
        echo 'Product '.$sku.' created successfully';
    } catch (\Exception $e) {
        echo 'Error creating product '.$sku.': '.$e->getMessage();
    }
}

// 辅助方法：检查URL key是否重复
private function isUrlKeyDuplicate($urlKey) {
    $storeId = $this->storeManager->getStore()->getId(); // 注入StoreManagerInterface依赖
    $productCollection = $this->productFactory->create()->getCollection()
        ->addAttributeToFilter('url_key', $urlKey)
        ->addAttributeToFilter('store_id', $storeId)
        ->setPageSize(1);
    
    return $productCollection->getSize() > 0;
}

思路2：使用Magento内置的URL生成服务（推荐） #

Magento本身提供了处理URL key唯一性的服务，直接调用就能自动生成唯一的URL key，不用自己写循环检查，更优雅也更符合Magento的规范：

代码示例 #

首先确保注入\Magento\CatalogUrlRewrite\Model\ProductUrlPathGenerator依赖，然后：

$sku = $row[0]; 
$name = $row[1]; 
$product = $this->productFactory->create();
$existingProductId = $product->getIdBySku($sku); 

if($existingProductId) { 
    echo 'Product with SKU '.$sku.' already exists'; 
} else { 
    $product->setSku($sku); 
    $product->setName($name); 

    // 调用内置服务生成唯一URL key
    $urlKey = $this->productUrlPathGenerator->getUrlKey($product);
    $product->setUrlKey($urlKey);

    // 其他属性设置...
    $product->save();
}

为什么会出现这个错误？ #

• 默认情况下，如果你没有手动设置url_key，Magento在保存商品时会自动基于商品名称生成
• 如果有两个商品名称转成URL key后完全相同（比如"Test Product"和"test product"都会生成test-product），就会触发重复错误
• 你的原始代码只检查了SKU的唯一性，忽略了URL key的全局唯一性要求

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