Bitbucket Pipeline运行AEM项目时提示Unknown packaging: content-package

1. 插件仓库配置不完整，导致关键插件无法下载 #

content-package是Adobe AEM专属的打包类型，依赖com.day.jcr.vault:content-package-maven-plugin提供支持。如果Bitbucket Pipeline的settings.xml里只配置了普通依赖仓库，没配置插件仓库（pluginRepositories），Maven会找不到这个插件，进而识别不了content-package打包类型。

需检查settings.xml是否同时配置了以下仓库和插件仓库：

<!-- 依赖仓库 -->
<repositories>
    <repository>
        <id>adobe-public-releases</id>
        <url>https://repo.adobe.com/nexus/content/groups/public/</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>false</enabled></snapshots>
    </repository>
</repositories>

<!-- 插件仓库（必须配置，否则Maven找不到content-package插件） -->
<pluginRepositories>
    <pluginRepository>
        <id>adobe-public-releases</id>
        <url>https://repo.adobe.com/nexus/content/groups/public/</url>
        <releases><enabled>true</enabled></releases>
        <snapshots><enabled>false</enabled></snapshots>
    </pluginRepository>
</pluginRepositories>

2. 主POM的pluginManagement配置缺失关键参数 #

即使你已配置content-package-maven-plugin，如果没开启extensions=true，插件也无法向Maven注册自定义打包类型。这是最常见的遗漏点。

检查主POM的pluginManagement配置，必须包含extensions参数：

<pluginManagement>
    <plugins>
        <plugin>
            <groupId>com.day.jcr.vault</groupId>
            <artifactId>content-package-maven-plugin</artifactId>
            <version>1.2.10</version> <!-- 对应archetype 50的适配版本 -->
            <extensions>true</extensions> <!-- 核心配置，必须设为true -->
            <configuration>
                <!-- 你的自定义配置 -->
            </configuration>
        </plugin>
    </plugins>
</pluginManagement>

3. Bitbucket Pipeline的Maven缓存异常 #

如果Pipeline曾缓存过不完整的插件包，可能导致content-package-maven-plugin无法正常加载。可以在构建脚本中清理对应插件的缓存，强制重新下载：

script:
  - rm -rf ~/.m2/repository/com/day/jcr/vault/content-package-maven-plugin
  - mvn clean install

4. Maven命令执行路径错误 #

确保Pipeline中的Maven命令是在项目根目录执行的。如果直接进入子模块目录执行命令，子项目无法继承主POM的pluginManagement配置，自然识别不了content-package打包类型。比如要执行mvn release:prepare release:perform，而非先进入ui.content这类子模块再执行命令。

内容的提问来源于stack exchange，提问作者Sebastian Stein