Magento 2 REST API更新库存后内置全页缓存(FPC)被完全清空问题求解

问题根因确认 #

• 核心是Magento 2默认配置下，库存变更会触发产品关联的所有分类缓存标签失效，而顶部导航菜单块默认绑定了所有分类的缓存标签，一旦有任意分类标签失效，就会触发包含该菜单的所有页面（分类页、产品页、CMS页）的FPC全部刷新，这是全量清缓存的核心原因。
• 订单发货触发库存扣减时，会走相同的库存更新逻辑，所以也会触发相同的缓存刷新问题。

可行落地方案 #

方案1：调整顶部菜单缓存标签绑定逻辑（推荐，改造成本低，无副作用） #

1. 重写Magento\Theme\Block\Html\Topmenu块的getCacheTags方法，移除默认绑定的所有分类缓存标签，改为仅绑定菜单自身的缓存标签，代码示例：

public function getCacheTags()
{
    return [\Magento\Framework\View\Element\AbstractBlock::CACHE_GROUP, 'topmenu_navigation'];
}

2. 单独新增菜单更新的触发逻辑：仅当分类增删、分类名称/URL变更时，才清理顶部菜单的缓存，其他场景（比如产品库存变更）不再触发菜单缓存失效。

方案2：改写库存更新的缓存失效逻辑（适配精准刷新需求） #

1. 重写Magento\CatalogInventory\Model\Indexer\Stock\CacheTags类，或者为cataloginventory_stock_item的saved事件创建后置插件，拦截库存更新事件，默认逻辑会自动关联产品所属的所有分类、父产品的缓存标签，你可以修改失效标签列表，仅保留当前库存变动的单品、以及对应的父产品（可配置/捆绑/分组产品）的缓存标签：

// 插件示例 拦截stock item保存后的缓存清理逻辑
public function afterGetIdentities(\Magento\CatalogInventory\Model\Indexer\Stock\CacheTags $subject, $result, $productIds)
{
    $tags = [];
    foreach ($productIds as $productId) {
        $tags[] = \Magento\Catalog\Model\Product::CACHE_TAG . '_' . $productId;
        // 补充查询当前产品的父产品ID，加入标签
        $parentIds = $this->parentProductLookup->getParentIdsByChild($productId);
        foreach ($parentIds as $parentId) {
            $tags[] = \Magento\Catalog\Model\Product::CACHE_TAG . '_' . $parentId;
        }
    }
    return $tags;
}

2. 关闭系统默认的catalog_category_product索引关联的缓存自动刷新，这个索引的变动会触发分类页缓存失效，库存变更不需要刷新这个索引的关联缓存。

临时兼容方案 #

如果暂时没有开发资源做二开，可以先调整库存更新逻辑的触发范围：

• 同步库存调用REST API时，使用局部更新接口PUT /V1/products/{sku}/stock-items/{itemId}，并且传入参数saveOptions: true，ignoreStockStatusChanged: true，减少不必要的事件触发。
• 后台进入「存储 > 配置 > 高级 > 系统 > 全页缓存」，将TTL for public content设置为合理值（比如24小时），同时开启「静态内容缓存」，降低全量刷新后的页面加载压力。

验证方法 #

修改完成后可以通过以下步骤验证效果：

1. 先清理所有缓存，访问前端各页面，查看FPC缓存的生成状态。
2. 调用库存更新接口修改某一个产品的库存，查看Redis/文件缓存中，只有对应产品ID的缓存标签被清理，其他页面缓存保持不变。
3. 验证分类页、CMS页的缓存未被刷新，访问速度无变化。

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