文档Experience Cloud KCS

Adobe Commerce部署期间未找到修补程序错误

最近更新： 2026年8月14日

Adobe Commerce部署或手动修补应用程序失败，升级后出现​未找到修补程序的错误。 该环境引用了目标Adobe Commerce版本不可用的修补程序，或者它使用过时的质量修补程序工具软件包，该软件包无法识别受支持的修补程序版本。 查看配置的修补程序ID，验证目标版本的修补程序兼容性，并在重新部署之前删除不支持的修补程序引用。

描述 description

环境

  • 云基础架构上的Adobe Commerce
  • 升级使用.magento.env.yaml的部署
  • Quality Patches Tool (QPT)
  • 适用使用供应商/bin/magento-patches的手动修补程序应用程序

问题/症状

  • Adobe Commerce升级后，部署或手动修补应用程序失败。

  • 部署日志显示错误，例如：

    • 未找到下一个修补程序： MDVA-XXXXX、ACSD-XXXXX
    • 未找到下一个修补程序： ACSD-12345

  • 日志建议使用status命令检查修补程序可用性。

原因

出现以下情况时，会发生此问题：

  • 在.magento.env.yaml中配置的修补程序ID不可用于目标Adobe Commerce版本。
  • 升级后，以前应用的修补程序不再适用。
  • 已安装的Quality Patches Tool (QPT)软件包已过时，无法识别较新的修补程序变体。

解决方法 resolution

按照以下步骤解决问题

  1. 查看.magento.env.yaml.中的QUALITY_PATCHES部分

  2. 识别所有已配置的修补程序ID。

  3. 验证Quality Patches Release Notes中的每个修补程序ID是否与目标Adobe Commerce版本兼容。

  4. 如果不支持所需的修补程序版本，请更新Quality Patches Tool (QPT)包。

  5. 从配置中删除不支持或过时的修补程序ID。

  6. 保存更改，推送更新的代码，然后重新部署环境。

  7. 如果手动应用修补程序，请在运行之前验证修补程序的兼容性：

    code language-none 
    vendor/bin/magento-patches apply

相关阅读

在Commerce on Cloud Infrastructure指南中应用修补程序。

recommendation-more-help
experience-cloud-kcs-help-kbarticles