文件Experience Cloud KCS

AEM Cloud Manager： ui.content套件版本衝突會封鎖較低環境中的部署

最後更新： 2026年8月1日

本文說明靜態套件版本如何防止在Adobe Experience Manager Cloud Manager管道上的較低環境中部署ui.content套件。

說明 description

環境

Adobe Experience Manager (AEM) Cloud Manager （所有版本）

問題/症狀

透過Cloud Manager管道部署到較低環境（例如Dev、E2E2或PLRT）時，如果具有相同版本的套件已存在，則 ui.content 套件無法上傳。 部署記錄檔未顯示錯誤，但是未重新安裝或更新套件。 在生產管道中，相同套件已成功上傳，因為每個組建都會產生唯一的時間戳記版本。

來自生產環境的範例記錄摘錄：

Set project version to 5.0.0.2025_0524_1104410_0008467799 from 5.0.0
Executing command mvn --batch-mode org.codehaus.mojo:versions-maven-plugin:2.6:set -DnewVersion=5.0.0.2025_0524_1104410_0008467799 ...

來自較低環境的範例記錄檔摘錄：

Executing command mvn --batch-mode org.apache.maven.plugins:maven-dependency-plugin:3.1.2:resolve-plugins
  • 在較低的環境中建置時，此問題可重複產生。
  • 由於相依性管理需求，專案版本已修正（例如： 5.0.0）。
  • 未顯示任何錯誤，但如果版本未變更，則不會更新套件。

如需詳細資訊，請參閱Cloud Manager中的專案版本處理和非生產管道中的SNAPSHOT使用情形。

原因

如果封裝版本未變更且已存在，Cloud Manager會略過在較低層環境中安裝封裝。 生產管道可透過為每個組建產生唯一的時間戳記版本來避免這種情況，而較低環境需要SNAPSHOT版本或手動版本增量來強制重新安裝。

解決方法 resolution

請依照下列步驟解決問題：

  1. 瞭解Cloud Manager版本處理

    • 在生產管道中，Cloud Manager會自動為每個組建產生唯一的時間戳記版本，以允許重新安裝套件，即使存在舊版也是如此。
    • 在較低層級的環境中，Cloud Manager不會自動遞增版本，並預期開發人員組建的專案版本為-SNAPSHOT。

  2. 選項1：對較低環境使用-SNAPSHOT

    • 對於僅用於較低環境的分支，請更新pom.xml專案版本以包含-SNAPSHOT （例如： <version>5.0.0-SNAPSHOT</version>）。
    • 確定所有模組（例如ui.apps、ui.content）都繼承此SNAPSHOT版本。
    • 這可讓Cloud Manager將這些視為可變的成品，並重新安裝，即使版本未變更亦然。

  3. 選項2：手動增加每個部署的版本

    • 如果需要使用靜態版本（由於相依性管理或其他原則），請手動在pom.xml中為每個部署遞增專案版本到較低環境。
    • 這可確保Cloud Manager將套件辨識為新版本並安裝。

  4. 檢閱和測試

    • 進行版本設定變更後，觸發新的管道部署，以確認ui.content套件已如預期上傳和安裝。
recommendation-more-help
experience-cloud-kcs-help-kbarticles