Adobe Commerce项目根目录中会出现意外的SHA-256命名文件

本文介绍了一个已知问题,其中在应用2026年10月隔离的安全修补程序后,在Adobe Commerce项目根目录中创建了一个名称为长十六进制的文件。

描述 description

受影响的产品和版本

仅当同时满足以下两个条件时,才会出现此问题:

  • 您已应用2026年10月隔离安全修补程序(APSB26-153),并且

  • 您正在云基础架构、Adobe Commerce内部部署或Magento Open Source上以下任一版本上运行Adobe Commerce:

    • 2.4.10-alpha1
    • 2.4.9
    • 2.4.8-p5
    • 2.4.7-p10
    • 2.4.6-p15
    • 2.4.5-p17
    • 2.4.4-p18

开发模式和生产模式都会受到影响。

未应用2026年10月隔离修补程序的安装不会受到影响。

问题

应用2026年10月隔离安全修补程序后,在项目根目录中创建了一个名为、包含64个字符的十六进制字符串的空文件:

976bc24c08055e67a58cf491401c8b2f3d48ff55b8092f1ede196bac4756a228

该名称在所有受影响的安装中都相同。

要复制,请从项目根目录中运行以下命令:

rm -f 976bc24c08055e67a58cf491401c8b2f3d48ff55b8092f1ede196bac4756a228
touch var/.regenerate
bin/magento

文件将重新出现。 不需要运行bin/magento setup:upgrade — 在var/.regenerate触发器存在的情况下,任何bin/magento调用都会重新创建它。

原因

对2026年10月日隔离安全修补程序中包含的Magento\Framework\Lock\Backend\FileLock中基于文件的锁定所做的更改更改更改了锁定文件名的派生方式。 因此,generated-files清理锁定将写入到安装根目录中的散列名称,而不是其以前位于var/.regenerate.lock的位置。

解决方法 resolution

Adobe已将此识别为意外副作用,并将在即将发布的版本中恢复之前的锁定文件位置。

无需客户执行任何操作即可保持受到保护 — ​ 2026年10月独立修补程序交付的安全修补程序不受此问题影响,您不应撤销该修补程序。

在更正的发行版本可用之前,您可以安全地忽略该文件。 它是一个空的锁定文件,不包含配置、凭据或客户数据,并且其存在并不表示配置错误或安装受到危害。

要将其置于源代码管理之外,请将其添加到您的.gitignore:

/976bc24c08055e67a58cf491401c8b2f3d48ff55b8092f1ede196bac4756a228
WARNING
在bin/magento命令、cron或部署进程运行时不删除文件。 锁定是建议性的,并且绑定到文件本身,因此删除它不会释放当前持有的锁定 — 后续进程将创建新文件并获得其自身的锁定,从而允许同时运行两个清理进程。

其他信息

  • 在Adobe Commerce on Cloud基础架构上,文件将写入每次部署的项目根目录中。 这是正常情况,不需要支持票证。
  • 有关2026年10月安全更新和修补程序下载链接,请参阅可用于Adobe Commerce的安全更新 — APSB26-153。
recommendation-more-help
experience-cloud-kcs-help-kbarticles