[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

ACP2E-3789：通过WebAPI在产品更新时复制的媒体文件

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
目录管理
缓存

创建对象：

有经验的
管理员
开发人员

ACP2E-3789修补程序修复了在提供媒体ID时通过WebAPI进行产品更新时复制媒体文件的问题。安装Quality Patches Tool (QPT) 1.1.66时，此修补程序可用。修补程序ID为ACP2E-3789。请注意，此问题计划在Adobe Commerce 2.4.9中修复。

受影响的产品和版本

为Adobe Commerce版本创建了修补程序：

Adobe Commerce（所有部署方法） 2.4.7-p3

与Adobe Commerce版本兼容：

Adobe Commerce（所有部署方法） 2.4.5 - 2.4.8

NOTE

该修补程序可能适用于具有新Quality Patches Tool发行版本的其他版本。要检查修补程序是否与您的Adobe Commerce版本兼容，请将magento/quality-patches包更新到最新版本，并在Quality Patches Tool：搜索修补程序页面上检查兼容性。使用修补程序ID作为搜索关键字来查找修补程序。

问题

使用媒体ID通过WebAPI更新产品会导致系统复制媒体文件，而不是替换它们，使用每个API调用创建新文件，并导致图像栈积，从而过载/pub/media/catalog/products/cache/目录。

重现步骤：

创建产品并添加图像。
使用位于base_url/rest/V1/products/<sku>的REST API获取产品详细信息。
执行PUT请求以更新产品，并保持media_gallery_entrie不变（相同的图像名称和文件）。
检查更新前后的pub/media/catalog/product/xx/yy目录。

预期的结果：

当请求中包含媒体ID时，将替换图像文件。

实际结果：

图像复制时使用了新名称（例如，wb04-blue-1.jpg），从而导致不必要的文件栈积。

应用修补程序

要应用单独的修补程序，请根据您的部署方法使用以下链接：

Adobe Commerce或Magento Open Source内部部署： Quality Patches Tool 指南中的>使用情况Quality Patches Tool。
云基础架构上的Adobe Commerce：云基础架构上的Commerce指南中的升级和修补程序>应用修补程序。

ACP2E-3789：通过WebAPI在产品更新时复制的媒体文件

受影响的产品和版本

问题

应用修补程序

相关阅读