文件

無法在雲端基礎結構上的Adobe Commerce上產生靜態內容

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

在雲端基礎結構上的Adobe Commerce部署期間，由於環境變數的設定錯誤，無法產生靜態內容。 發生錯誤​ 無法建立"/app/…/.htaccess" ​的symlink （在建置程式期間發生）或遺失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