OSGi项目中无法使用mongodb-driver-sync：依赖解析失败求助

一、MongoDB驱动的OSGi兼容性说明 #

MongoDB 4.1.x及更早版本的官方文档明确标注支持OSGi，但4.3.x之后文档移除了相关内容——不过驱动的MANIFEST里还保留着Bundle元数据，这是因为官方不再主动测试OSGi场景的兼容性，但代码层面未移除相关配置，属于“半支持”状态。
你测试的4.1.0版本理论上是合规的OSGi Bundle，但实际出现依赖问题，大概率是依赖链不完整：mongodb-driver-sync依赖mongodb-driver-core和bson两个包，这两者也需要是OSGi兼容版本，且版本必须与sync驱动严格对齐。

二、集成配置排查步骤 #

1. 补全依赖项
   • 在pom.xml中需同时引入mongodb-driver-sync、mongodb-driver-core、bson三个包，版本统一为4.1.0（或你测试的目标版本），按Karaf特性要求配置依赖范围。
   • 在feature.xml里要把这三个包都加入feature的bundle列表，不能只添加sync驱动。示例配置：

     <feature name="your-mongo-feature" version="1.0.0">
         <bundle>mvn:org.mongodb/bson/4.1.0</bundle>
         <bundle>mvn:org.mongodb/mongodb-driver-core/4.1.0</bundle>
         <bundle>mvn:org.mongodb/mongodb-driver-sync/4.1.0</bundle>
         <!-- 其他依赖如Camel MongoDB组件等 -->
     </feature>
     

2. 手动验证Bundle元数据
   • 用Karaf命令手动安装驱动：bundle:install -s mvn:org.mongodb/mongodb-driver-sync/4.1.0
   • 执行bundle:headers <bundle-id>查看Import-Package和Export-Package信息，确认com.mongodb的版本范围是否与报错信息匹配，是否存在未满足的隐式依赖。
3. 核对Camel组件版本兼容性
   • 确保使用的Camel MongoDB组件（camel-mongodb）版本与MongoDB驱动兼容。比如Camel 3.x适配MongoDB 4.x驱动，Camel 2.x更适配3.x驱动，版本不匹配会间接导致依赖解析失败。

三、替代方案 #

如果官方驱动的OSGi兼容性不稳定，可尝试以下两种方式：

• 直接使用Camel MongoDB组件的封装：Camel的mongodb组件已对驱动做了一层封装，部分版本会内置兼容的驱动依赖，直接引入Camel的feature即可避开手动处理驱动OSGi依赖的问题。
• 自定义OSGi Bundle：若官方驱动的MANIFEST元数据存在问题，可下载驱动jar包后用bnd工具重新生成MANIFEST，补全Import/Export信息，制作成自定义的OSGi Bundle使用。

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