文档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