Magento Open Source 2.4.6发行说明

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

Magento Open Source 2.4.6引入了对PHP 8.2的支持。PHP 8.1仍得到完全支持，但对PHP 7.4的支持已被删除。它包含重要的性能和可扩展性增强功能。已优化用于批量购物车操作和类别树渲染响应的GraphQL操作。

此版本包括质量修复和增强功能。核心编辑器依赖项和第三方库已升级到与PHP 8.2兼容的最新版本。

Adobe Commerce版本可能包含向后不兼容的更改(BIC)。要查看与向后不兼容的更改，请参阅 BIC参考。在 BIC亮点中描述了严重的向后不兼容问题。并非所有发行版本都引进了主要BIC。

其他发行信息

虽然这些功能的代码与Magento Open Source核心代码的发行版本捆绑在一起，但其中几个项目也单独发布。每个项目的文档中都提供了特定于项目的单独发行信息，其中记录了这些项目的错误修复。

Magento Open Source 2.4.6亮点

在此版本中查找以下要点。

安全性增强

此版本包括八项安全修复和平台安全改进。

到目前为止，尚未发生与这些问题相关的已确认攻击。但是，可能会利用某些漏洞访问客户信息或接管管理员会话。这些问题中的大多数要求攻击者首先获得对管理员的访问权限。因此，我们提醒您采取一切必要步骤保护您的管理员，包括但不限于以下工作：

管理员用户更改其电子邮件时需要确认电子邮件的新系统配置 。为了减少站点漏洞，添加了一个新的系统配置设置（默认禁用），当管理员用户更改其电子邮件时，该设置需要确认电子邮件： Stores > Settings:Configuration > Customers > Customer Configuration > Account Information Options > Require email confirmation if an email has been changed 。启用此选项后，每当管理员用户更改其电子邮件地址时，应用程序都会请求电子邮件确认。以下模块受此更改影响： Magento_Customer 。

平台增强功能

Magento Open Source 2.4.6引入了对PHP 8.2的支持。PHP 8.1仍得到完全支持。

已从此版本中删除PHP 7.4支持。您无法在PHP 7.4上运行Magento Open Source 2.4.6。

Magento Open Source现在支持：

现在，支持将OpenSearch用作Magento Open Source内部部署和云部署的默认搜索引擎。它支持作为Magento Open Source的独立搜索引擎。此版本支持OpenSearch v2.x，并已经过OpenSearch 2.5测试。尽管与OpenSearch 1.x的兼容性仍然存在，但我们建议将此版本与OpenSearch 2.x一起使用。您可以在云和本地搜索引擎先决条件上安装并运行带有OpenSearch 2.x的Magento Open Source和Magento Open Source 2.4.6。

Elasticsearch 8.x。请参阅升级Elasticsearch 。

MariaDB 10.6（LTS版本）。此版本仍与MariaDB 10.4兼容，但我们建议升级到MariaDB 10.6。

新 adobe-ims-metapackage v2.2.0与Adobe Commerce 2.4.6和Magento Open Source 2.4.6捆绑在一起。此版本中未更改任何功能。

Braintree

GraphQL解析程序操作已得到优化。

数据提供程序不再为正在处理的每个新产品重新设置运行时缓存的数据，这提高了性能。

已在GraphQL解析程序中优化产品权限处理。产品权限现在改为按产品应用到产品收藏集。

已优化


    addProductsToCart

突变中共享目录中的权限读取。

产品权限已通过产品内联片段进行优化。

减少了批量购物车操作的查询响应时间 。当添加多达500个简单且可配置的产品时，“添加产品突变”已得到优化，以提高查询性能。捆绑产品不受影响。优化的变动包括 addProductsToCart 、 addConfigurableProductsToCart 、 addDownloadableProductsToCart 、 addSimpleProductsToCart 、 addVirtualProductsToCart 、 addWishlistItemsToCart 和 updateCartItems 。

客户查询现在支持订单排序 。 orders 查询的 customer 输出对象现在包含排序字段。您现在可以按订单编号或创建日期以及升序或降序对订单进行排序。

新的突变：

deleteCustomer

页面生成器

Page Builder v.1.7.3与Magento Open Source 2.4.6兼容。

PWA Studio

PWA Studio v.13.0.x与Magento Open Source 2.4.6兼容。它包括多项增强功能，可改善辅助功能。有关错误修复的信息，请参阅 PWA Studio发行版。有关PWA Studio版本及其兼容的Adobe Commerce核心版本的列表，请参阅版本兼容性。

问题： New Relic当前与PHP 8.2不兼容。运行New Relic的部署可以在PHP 8.1上运行Adobe Commerce 2.4.6，但不能在PHP 8.2上运行。 解决方法 ：在PHP 8.1上运行Adobe Commerce 2.4.6，直到发布支持PHP 8.2的新版本的New Relic为止。此版本预计于2023年夏季发布。

修复的问题

我们已在Magento Open Source 2.4.6核心代码中修复了数百个问题。

安装、升级、部署

在已运行数据迁移工具的部署中运行


    bin/magento setup:upgrade

命令时，Magento Open Source不再引发以下异常：


    PHP Fatal error: Declaration of Migration\Logger\Logger::addRecord(int $level, string $message, array $context = []): bool must be compatible with Monolog\Logger::addRecord(int $level, string $message, array $context = [], ?Monolog\DateTimeImmutable $datetime = null): bool in /var/www/html/vendor/magento/data-migration-tool/src/Migration/Logger/Logger.php on line 34

。 GitHub-35604

当 Store 欧盟国家/地区 Configuration 设置中没有国家/地区( > > Stores > Configuration > General )时，管理员用户现在可以成功打开管理员 Country options > European Union Countries 页面。以前，当管理员用户尝试打开此页面时，Magento Open Source引发此错误：


    TypeError: explode(): Argument #2 ($string) must be of type string, null given in /var/www/php/folder/vendor/magento/module-config/ViewModel/CountryFilter.php:46

。 GitHub-35901

现在，如果商家在创建产品时未能输入可选的SKU属性值，Magento Open Source会显示信息性错误消息。以前，当属性为可选属性时，应用程序引发此异常：


    Deprecated Functionality: trim(): Passing null to parameter #1 ($string) of type string is deprecated in /var/www/html/mg244/project-community-edition/vendor/magento/module-eav/Model/Entity/AbstractEntity.php on line 932

。 GitHub-35810

已解决Google V3 reCAPTCHA管理员登录的


    var/log/exception.log

文件中的reCAPTCHA错误，并且未记录任何错误消息。以前，当管理员用户配置其 Configuration > Security > Google reCAPTCHA Admin Panel 设置时，每隔几秒会引发一次以下错误：


    main.ERROR: Can not resolve reCAPTCHA parameter. {"exception":"[object] (Magento\Framework\Exception\InputException(code: 0): Can not resolve reCAPTCHA parameter. at /home/xxxxxxx/public_html/vendor/magento/module-re-captcha-ui/Model/CaptchaResponseResolver.php:25)"} []

。 GitHub-34975

Magento Open Source现在可以在运行PHP 8.1的部署中的storefront category页面上显示已分组的含税产品。以前，Magento Open Source不显示产品列表，并引发此异常：


    main.CRITICAL: Exception: Deprecated Functionality: ucfirst(): Passing null to parameter #1 ($string) of type string is deprecated in /var/www/m24/vendor/magento/module-tax/Pricing/Render/Adjustment.php on line 188 in /var/www/m24/vendor/magento/framework/App/ErrorHandler.php:61

。 GitHub-35500

问题：如果启用免运费( Stores > Configuration > Sales > Delivery Methods )，并且显示的运费含税，则无法创建贷项通知单。当您尝试创建贷项通知单时，Adobe Commerce会引发此异常： "Division by zero".vendor/magento/module-sales/Model/Order/Creditmemo/Total/Tax.phpLine 139 。 GitHub-36800

解决方法 ：此问题的修补程序现已可用。转到 Quality Patches Tool：搜索修补程序并搜索修补程序ACSD-50814。

我们感谢更广泛的Magento Open Source社区，并感谢他们为这一版本做出的贡献。

社区工程团队 Magento参与者按月、季度、年维护了主要参与人员和合作伙伴的列表。从该参与者页面，您可以单击链接以转到GitHub上其合并的PR。

合作伙伴投稿

下表列出了合作伙伴所做的贡献。此表列出了提出拉取请求的合作伙伴、外部拉取请求编号以及与其关联的GitHub问题编号（如果可用）。