文档

禁用Adobe Commerce横幅输出以提高网站性能

Last update: Wed Apr 15 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

本文提供了解决站点性能不佳的方法。 启用Magento_Banner模块但未使用时，可能会出现性能问题。 禁用模块输出可以提高网站性能；但是，此操作会从管理员中删除动态块功能。

描述 description

环境

  • 云基础架构上的Adobe Commerce v.2.4.x
  • Adobe Commerce内部部署v.2.4.x

问题/症状

Magento_Banner模块已启用，但未使用。

要检查是否出现这种情况，请执行以下操作：

对于Adobe Commerce on cloud infrastructure 2.3.x及更高版本（在v 2.3.x中功能已重命名）：

  1. 登录到Commerce管理员。
  2. 导航到内容 > 元素 > 动态块。
  3. 如果此页面上显示的网格为空，则表示您没有任何动态块（横幅）。

如果您在 Content 下看不到 动态块 选项 > 元素，这意味着您已应用此文章中的推荐。 若要再次查看横幅选项，请反转此过程。

根本原因

启用Magento_Banner模块后，Adobe Commerce会将Ajax请求从店面发送到服务器以获取横幅信息。 这些Ajax请求会对性能产生影响，尤其是在高负载（高容量和高流量）情况下。 如果未使用该功能，建议您禁用模块输出。 由于存在依赖性问题，因此不建议禁用该模块。

解决方法 resolution

警告： 我们强烈建议先在暂存/集成环境上测试更改，然后再将其应用于生产。 我们还建议在进行任何操作之前进行最近备份。

  1. 禁用Magento_Banner模块输出，如开发人员文档中的禁用模块输出中所述。 您需要使用的模块名称为Magento_Banner。
  2. 部署代码。 对于云基础架构上的Adobe Commerce，请按照开发人员文档中的部署您的存储库文章中的说明进行部署。
  3. 禁用模块输出后，该菜单不再出现在管理员中。
  4. 您不会再在Content > Elements下看到“横幅”或“动态”选项。

还原动态块功能

  1. 在本地代码库中编辑app/etc/config.php。

  2. 找到并删除Magento_Banner禁用输出配置。
    如果“管理员”中缺少“动态块”菜单，请确保Magento_Banner中未禁用app/etc/config.php模块输出。
    如果Magento_Banner是 高级 下列出的唯一模块 > modules_disable_output，您可以删除下面的整个部分（全部5行）：

    code language-none 
    'advanced' =>[         'modules_disable_output' =>[             'Magento_Banner' => '1'        ]     ] ,

    如果其他模块必须保持禁用状态，请仅删除Magento_Banner条目，并确保数组中的最后一个条目不以尾随逗号结尾，例如：

    code language-none 
    'advanced' =>[         'modules_disable_output' =>[             'First_Disabled_Module' => '1',            'Second_Disabled_Module' => '1'        ]     ] ,

  3. 提交更改并重新部署环境。

  4. 您不会再在 Content 下看到“横幅”或“动态”选项 > 元素。 若要再次显示选项，请启用模块输出。

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f