文档Experience Cloud KCS

云基础架构上Adobe Commerce中的远程存储库未同步发布/错误文件

最近更新： 2026年6月22日

在Adobe Commerce on Cloud Infrastructure中，暂存和生产实例上的pub/errors文件不反映远程存储库的最新版本。 当部署过程在环境构建期间恢复或覆盖文件时，会发生此问题，这会阻止直接文件更改在云实例上持续存在。 要解决此问题，必须使用受支持的基于修补程序的部署流正确同步这些文件。

描述 description

环境

云基础架构上的Adobe Commerce

问题/症状

  • Cloud Infrastructure实例上Adobe Commerce中pub/errors下的文件不反映远程存储库的最新版本。
  • 通过SSH比较文件内容显示，暂存或生产环境中的pub/errors文件与Git中的文件不同。
  • 每次部署后，直接对实例上的pub/errors文件所做的自定义都将丢失或还原。

原因

在Adobe Commerce Cloud中，某些文件与自定义模块或主题不同，不是项目拥有的。 Adobe Commerce基本包、编辑器管理的依赖项或部署时工具提供了这些文件，并且云部署可以重新创建或覆盖它们。

在部署期间，Adobe Commerce Cloud使用ece-tools以及适用于Commerce的Cloud Patches和Quality Patches Tool来构建和准备代码库。 系统按以下顺序应用挂起的修补程序：

  • Cloud Patches for Commerce中所需的Commerce修补程序
  • 从“质量修补程序工具”中选择的可选修补程序
  • 来自m2-hotfixes的自定义修补程序，按修补程序名称的字母顺序应用

因此，部署可以恢复、重建或覆盖由Adobe Commerce包或编辑器管理的依赖项提供的文件。 如果在支持的修补程序流之外自定义这些文件，则下一个部署将替换这些更改。

解决方法 resolution

在部署期间，Cloud Infrastructure上的Adobe Commerce将按照定义的顺序应用修补程序。 处理完必需的Commerce修补程序和所选的可选修补程序后，部署将应用m2-hotfixes目录中的自定义修补程序。 此过程确保在每次部署期间始终如一地重新应用您的自定义。

要保留对Adobe Commerce管理或编辑器管理的文件所做的更改，请执行以下步骤：

  1. 为所需的更改创建自定义修补程序。
  2. 将修补程序放在m2-hotfixes中的项目根目录下。
  3. 提交并推送修补程序文件。
  4. 重新部署环境。

相关阅读

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