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

ACP2E-4613：大型媒体目录导致媒体集目录树的加载延迟

Last update: Thu Apr 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

有经验的
管理员
开发人员

ACP2E-4613修补程序修复了大型媒体目录结构导致gettree响应缓慢，从而导致 Media Gallery 目录树的加载时间延长的问题。安装Quality Patches Tool (QPT) 1.1.78时，此修补程序可用。修补程序ID为ACP2E-4613。请注意，此问题计划在Adobe Commerce 2.4.9中修复。

受影响的产品和版本

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

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

与Adobe Commerce版本兼容：

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

NOTE

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

问题

大型媒体目录结构导致gettree响应缓慢，导致Media Gallery目录树的加载时间延长。

先决条件：

存在大量具有多个图像的产品。

重现步骤：

生成图像缩略图以增加媒体的占用空间：

code language-none
`bin/magento catalog:images:resize`

在pub/media/catalog/category下创建多个子目录（例如：test、test2、test3、test4以及根据需要创建的其他嵌套文件夹）。

将大量目录介质文件复制到新创建的目录中，以显着增加介质目录树的大小，例如：

code language-none
`cp -r pub/media/catalog/product/* pub/media/catalog/category/test/ cp -r pub/media/catalog/product/* pub/media/catalog/category/test2/ (...)`

登录到“管理员”面板，然后导航到Content > Media > Media Gallery。
请注意，admin/media_gallery/directories/gettree/?isAjax=true请求需要很长时间才能完成。

预期的结果：

几秒钟内即可加载目录树。

实际结果：

加载目录树需要几分钟时间，具体时间取决于pub/media下的子目录数量。

应用修补程序

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

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

ACP2E-4613：大型媒体目录导致媒体集目录树的加载延迟

受影响的产品和版本

问题

应用修补程序

相关阅读