Adobe AEM集成带依赖第三方Target SDK Jar包的正确方案咨询

非OSGi规范的第三方Jar缺少OSGi bundle必需的元数据头信息，直接声明Maven依赖部署会出现包无法解析的问题，手动逐层声明嵌入依赖的方式维护成本极高，以下是两种可落地的标准处理方案，可根据项目场景选择：

方案1：单bundle嵌入全量依赖（适合仅单个/少量子项目使用SDK的场景） #

不需要手动枚举所有传递依赖，通过maven-bundle-plugin的通配规则自动收集所有需要的依赖包，正确配置如下：

<plugin>
    <groupId>org.apache.felix</groupId>
    <artifactId>maven-bundle-plugin</artifactId>
    <configuration>
        <exportScr>true</exportScr>
        <instructions>
            <Embed-Dependency>
                target-java-sdk;scope=compile|runtime;inline=false,
                *;scope=compile|runtime;type=!pom;inline=false
            </Embed-Dependency>
            <Embed-Transitive>true</Embed-Transitive>
            <Private-Package>
                com.adobe.target.*,
                com.adobe.experiencecloud.*,
                io.github.jamsesso.*,
                kong.unirest.*,
                org.json.*,
                org.apache.http.*
            </Private-Package>
            <Import-Package>
                *;resolution:=optional
            </Import-Package>
        </instructions>
    </configuration>
</plugin>

配置核心注意点：

• 不要手动枚举依赖ID：通过通配符+作用域过滤让插件自动收集所有符合要求的传递依赖，后续SDK升级不需要调整插件配置
• 强制设置inline=false：将依赖以完整Jar形式嵌入bundle，避免拆解class文件导致依赖内部的SPI加载、资源文件读取逻辑失效
• 明确声明私有包：所有嵌入的第三方包标记为当前bundle私有，不对外导出，避免和AEM内置包、其他业务bundle的同包类产生版本冲突
• 导入规则加可选标记：第三方依赖常存在大量运行时非必需的可选依赖，给导入包规则加resolution:=optional可以避免这些非必需缺包导致bundle无法启动，该配置不会影响AEM内置API、其他已部署bundle导出API的正常引用，仅对不存在的依赖包做可选忽略处理

配置完成后执行mvn clean install构建，解压生成的bundle确认所有第三方Jar已经被包含在bundle根目录，再部署到AEM即可。

方案2：打包为独立公共OSGi Bundle（适合多个子项目共用SDK的场景） #

如果超过2个子项目需要引用Target SDK，把依赖嵌到每个子项目bundle里会导致包体积冗余、类冲突概率上升，此时可以单独构建公共依赖bundle：

• 在工程下新建一个专门打包第三方公共依赖的Maven模块
• 在该模块的pom中引入Target SDK依赖，配置maven-bundle-plugin把Target SDK及所有传递依赖中AEM未内置的包标记为导出包
• 构建得到独立的bundle包，部署到AEM的/apps/[项目名]/install目录下作为公共依赖
• 所有业务bundle后续只需要正常声明Target SDK的Maven依赖，不需要做嵌入配置即可直接引用相关类
• 打包时注意排除AEM已经内置的包（比如org.apache.http系列、slf4j系列包），避免出现类版本冲突。

常见问题排查点 #

• 如果嵌入依赖后还是报类找不到，先执行mvn dependency:tree查看依赖树，确认报错类对应的Jar包依赖scope为compile/runtime，没有被provided/test作用域排除
• 如果部署后报类转换异常、类加载冲突，先在AEM Web Console的包导出页面搜索报错的包名，确认是否已经有其他bundle导出了同包的不同版本，调整配置或者排除重复依赖即可
• 不要为了解决临时报错随意往Embed-Dependency里加单个依赖项，只要配置正确的通配规则，插件会自动处理全链路依赖。

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