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
bin/magento命令、cron或部署进程运行时不删除文件。 锁定是建议性的,并且绑定到文件本身,因此删除它不会释放当前持有的锁定 — 后续进程将创建新文件并获得其自身的锁定,从而允许同时运行两个清理进程。其他信息
- 在Adobe Commerce on Cloud基础架构上,文件将写入每次部署的项目根目录中。 这是正常情况,不需要支持票证。
- 有关2026年10月安全更新和修补程序下载链接,请参阅可用于Adobe Commerce的安全更新 — APSB26-153。