Magento 2.4.4（MSI）程序化更新库存数量与状态异常排查

我在程序化创建产品后，尝试更新其库存数量（XXX），但产品网格始终显示“数量：XXX，默认库存：0”。当前使用的是默认启用MultiSource Inventory（MSI）的Magento 2.4.4，仅配置了默认货源和默认库存。

已尝试的三种方案 #

1. 可行但已弃用的方案 #

创建产品代码：

/** @var \Magento\Catalog\Model\Product $product */
$product = $this->productFactory->create();
$product
   ->setTypeId(Type::TYPE_SIMPLE)
   ->setSku('test');
   // 其他产品属性设置

/** @var \Magento\Catalog\Api\ProductRepositoryInterface $this->productRepository */
$product = $this->productRepository->save($product);

后续更新库存代码：

/** @var \Magento\CatalogInventory\Model\Stock\Item $stockItem */
$stockItem = $product->getExtensionAttributes()->getStockItem();
$stockItem
    ->setIsInStock(true)
    ->setQty(XXX)
    ->setStockStatusChangedAuto(true);

$product = $this->productRepository->save($product);

2. 可行但已弃用的方案 #

$product->setQuantityAndStockStatus(['qty' => XXX, 'is_in_stock' => 1]);

$product = $this->productRepository->save($product);

3. 更新产品数量但未更新可售数量（inventory_stock_1表中数量为0、is_salable=0） #

/** @var \Magento\CatalogInventory\Model\Stock\Item $stockItem */
$stockItem = $product->getExtensionAttributes()->getStockItem();
$stockItem
    ->setIsInStock(true)
    ->setQty(XXX)
    ->setStockStatusChangedAuto(true);

/** @var \Magento\InventoryApi\Api\GetSourceItemsBySkuInterface $this->getSourceItemsBySku */
$stockItems = $this->getSourceItemsBySku->execute($product->getSku());
reset($stockItems)->setQuantity(XXX);
reset($stockItems)->setStatus(SourceItemInterface::STATUS_IN_STOCK);

/** @var \Magento\InventoryApi\Api\SourceItemsSaveInterface $this->sourceItemsSave */
$this->sourceItemsSave->execute($stockItems);

正确的MSI库存更新步骤（非弃用方式） #

你的第三种方案问题出在混用了旧的CatalogInventory API与新的MSI Inventory API，且未确保库存聚合数据同步。以下是完整的正确步骤：

1. 移除旧库存API操作代码 #

MSI模式下，旧的CatalogInventory系列接口已被弃用，不要再操作$product->getExtensionAttributes()->getStockItem()，否则会导致新旧库存数据不一致。

2. 确保产品关联默认货源并正确设置Source Item #

方式一：创建产品时同步配置Source Item

// 创建产品实例并设置基础属性
$product = $this->productFactory->create();
$product
   ->setTypeId(Type::TYPE_SIMPLE)
   ->setSku('test')
   ->setName('Test Product')
   ->setPrice(19.99)
   ->setVisibility(\Magento\Catalog\Model\Product\Visibility::VISIBILITY_BOTH)
   ->setStatus(\Magento\Catalog\Model\Product\Attribute\Source\Status::STATUS_ENABLED);

// 保存产品
$product = $this->productRepository->save($product);

// 创建默认货源的库存项
$sourceItem = $this->sourceItemFactory->create();
$sourceItem->setSku($product->getSku());
$sourceItem->setSourceCode('default'); // 默认货源编码
$sourceItem->setQuantity(XXX);
$sourceItem->setStatus(\Magento\InventoryApi\Api\Data\SourceItemInterface::STATUS_IN_STOCK);

// 保存Source Item
$this->sourceItemsSave->execute([$sourceItem]);

方式二：更新现有产品的Source Item并同步库存聚合

// 获取指定SKU的所有Source Items
$stockItems = $this->getSourceItemsBySku->execute($product->getSku());
foreach ($stockItems as $item) {
    // 仅更新默认货源的库存
    if ($item->getSourceCode() === 'default') {
        $item->setQuantity(XXX);
        $item->setStatus(\Magento\InventoryApi\Api\Data\SourceItemInterface::STATUS_IN_STOCK);
    }
}
// 保存更新后的Source Items
$this->sourceItemsSave->execute($stockItems);

// 手动触发库存索引聚合（解决同步延迟问题）
$this->inventoryIndexer->executeList([$product->getSku()]);

3. 关键注意事项 #

• 禁止混用新旧API：MSI模式下仅使用Magento\InventoryApi命名空间下的接口操作库存。
• 货源关联验证：确保产品已关联到默认货源（default），否则库存数据不会被聚合到inventory_stock_1表。
• 索引同步：若更新后数据未实时同步，可手动执行索引重建命令：

  bin/magento indexer:reindex inventory_stock
  

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