OSGI兼容Google Pub/Sub、Storage、Firestore三方jar共存时类找不到异常问题

排查依赖重复与类加载隔离问题 #

• 检查三个模块是否都依赖了Google Cloud基础库（如google-cloud-core）且各自嵌入了重复类。OSGI类加载器会因不同bundle的类重复/版本差异导致找不到类，建议将这类共享依赖抽成独立OSGI bundle，让三个业务模块统一依赖该共享bundle，而非各自打包依赖。
• 用OSGI控制台的bundle:diag <bundle-id>命令，或bnd工具检查每个模块的依赖缺失情况，定位具体缺失的类及应提供该类的bundle。

修正OSGI元数据（Import-Package/Export-Package） #

• 确保每个模块的Import-Package准确声明所需的所有类包（如com.google.cloud.storage、com.google.cloud.pubsub.v1等），避免过度使用通配符，同时指定合理版本范围（如[1.0.0,2.0.0)）。
• 检查共享依赖bundle的Export-Package是否正确导出了三个模块需要的基础类包，不要遗漏Google Cloud SDK中业务模块需用到的内部辅助类。

处理三方jar的OSGI兼容性问题 #

• 部分标注“OSGI兼容”的jar可能元数据不全（缺失Bundle-SymbolicName、Bundle-Version或Export-Package），可使用bndtools重新生成正确的OSGI元数据，或手动在MANIFEST.MF中补充这些信息。
• 统一所有模块依赖的三方jar版本，避免在不同模块中嵌入同一jar的不同版本，保证类定义的一致性。

调整OSGI容器类加载策略 #

• 若使用Apache Felix、Eclipse Equinox等容器，可临时测试开启类加载全局可见性（不推荐长期使用），或调整bundle启动顺序，确保共享依赖bundle先于业务模块启动。
• 针对Google Cloud SDK中部分动态加载类的场景，可在模块MANIFEST.MF中添加DynamicImport-Package: com.google.cloud.*作为临时方案，但优先使用显式的Import-Package声明。

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