文档

无法在Cloud基础架构上的Adobe Commerce上生成静态内容

Last update: Mon Jul 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

在云基础架构上的Adobe Commerce上进行部署期间，无法生成静态内容，原因通常是环境变量配置不正确。 发生错误​ 无法为“/app/…/.htaccess” ​创建符号链接等问题，或者缺少deployed_version.txt文件。 要解决此问题，请确保已启用CLEAN_STATIC_FILES并重新部署环境。

描述 description

环境

云基础架构上的Adobe Commerce

问题/症状

  • 部署期间不会生成静态内容。
  • 显示的错误： 无法为“/app/…/.htaccess”创建符号链接。
  • deployed_version.txt文件缺失或已过期。
  • 环境中的CLEAN_STATIC_FILES变量不一致。

解决方法 resolution

要解决此问题，请执行以下步骤：

  1. 检查CLEAN_STATIC_FILES变量，确保将其设置为已启用（或未设置，默认设置为已启用）。 您可以通过以下任意方式对此进行验证：

    • 通过SSH访问服务器（例如，节点01）并运行以下命令：

      code language-none 
      php -r 'echo json_decode(base64_decode($_ENV[ "MAGENTO_CLOUD_VARIABLES"] ))->CLEAN_STATIC_FILES . "\n";'

    • 检查存储库中的.magento.env.yaml文件以了解变量。

    • 在本地运行以下CLI命令：

      code language-none 
      magento-cloud variables:list -p <clusterID>

    • 请访问https://console.adobecommerce.com/username/<cluster ID>/<environment>/settings/variables上的Cloud Console以检查变量。

  2. 跨环境比较CLEAN_STATIC_FILES变量以确定差异（例如，在暂存环境中启用但在生产环境中禁用），并将其调整为“已启用”以确保一致性。

  3. 将更改推送到环境以触发重建并重新生成静态内容。

相关阅读

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f