升级CXF JAR包时OSGI双依赖链问题排查与解决咨询

1. 缺失依赖的原因：CXF 3.4.8的cxf-rt-frontend-jaxws Bundle在Import-Package中声明了对javax.xml.soap包的依赖，这是JAX-WS规范的核心API包，默认Felix框架或现有Bundle未提供该包，导致启动失败。
2. 依赖冲突的原因：手动添加javax.xml.soap-api-1.4.0.jar后，若该JAR未做OSGi适配（或适配不当），会与Felix框架导出的JDK自带javax.xml.soap包（通常版本较低）产生冲突——OSGi包解析器无法确定优先使用哪个Bundle提供的包，从而抛出约束冲突错误。

方案一：使用OSGi友好的javax.xml.soap API Bundle #

替换手动添加的普通JAR为专门适配OSGi的版本，推荐使用Apache Geronimo的规范包：

• 移除custo目录下的javax.xml.soap-api-1.4.0.jar
• 添加org.apache.geronimo.specs:geronimo-jaxws_2.3_spec:2.0.1（或与CXF 3.4.8匹配的版本）到custo目录
• 该Bundle已正确配置OSGi元数据，导出的javax.xml.soap包版本与CXF的导入需求兼容，且会通过OSGi的包隔离机制避免与系统包冲突

方案二：调整Felix系统包导出配置 #

通过修改Felix的系统配置，让框架直接导出符合版本要求的javax.xml.soap包：

1. 打开Felix的config.properties配置文件
2. 找到org.osgi.framework.system.packages.extra属性，添加：

   javax.xml.soap;version="1.4.0"
   

3. 保存配置并重启Felix
   • 此方案依赖JDK本身支持javax.xml.soap 1.4.0版本（Java 8及以上版本满足要求），无需额外安装第三方Bundle

方案三：重新打包javax.xml.soap-api-1.4.0.jar为OSGi兼容Bundle #

如果必须使用官方的javax.xml.soap-api-1.4.0.jar，可通过bnd工具重新打包，添加OSGi元数据：

1. 创建简单的bnd.bnd文件，内容如下：

   Export-Package: javax.xml.soap;version=1.4.0
   Bundle-SymbolicName: javax.xml.soap-api
   Bundle-Version: 1.4.0
   

2. 使用bnd工具执行打包命令：bnd wrap javax.xml.soap-api-1.4.0.jar
3. 将生成的OSGi兼容Bundle替换原JAR放入custo目录
   • 重新打包后的Bundle会明确导出版本，帮助OSGi解析器正确匹配CXF的导入需求

方案四：调整CXF Bundle的导入声明（应急方案） #

若无法修改其他Bundle，可临时调整cxf-rt-frontend-jaxws-3.4.8.jar的导入配置：

1. 使用bnd工具或OSGI Bundle编辑器打开该JAR
2. 修改Import-Package中的javax.xml.soap声明为宽松版本范围：

   javax.xml.soap;version="[1.3,2.0)"
   

3. 重新打包并替换原Bundle
   • 此方案降低了版本约束，可能解决冲突，但存在运行时兼容性风险，仅建议临时应急使用

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