OSGi环境升级xmlbeans3.1.0、poi-ooxml-schemas4.1.1后报类找不到错误

核心报错根因 #

该类加载错误并非单纯的jar包缺失，本质是OSGi类隔离机制下的双向配置缺口：

• poi-ooxml-schemas 4.1.1 版本的OSGi Bundle未声明对xmlbeans核心实现类包的导入规则
• xmlbeans 3.1.0 版本的OSGi Bundle默认未导出内部实现类包org.apache.xmlbeans.impl.schema，导致poi-schemas的类加载器跨Bundle查找类时无法定位到目标类
• 此前尝试的Dynamic-import方案未生效，核心原因是动态导入规则配置位置错误：多数场景下错误地将规则配置到xmlbeans自身Bundle上，而非类发起查找的poi-ooxml-schemas Bundle，且目标平台未将动态导入规则实际写入Bundle的Manifest清单头文件
• 此前引入xmlsec Bundle未解决问题的核心原因是，xmlsec组件本身和当前的类加载缺口无直接关联，没有补齐xmlbeans与poi-schemas之间的包暴露链路

分步落地修复步骤 #

• 校验目标平台内两个Bundle的实际清单配置
  分别打开两个Bundle的MANIFEST.MF文件确认配置缺口：
  • 检查org.apache.xmlbeans（3.1.0版本）的Export-Package配置：确认其是否导出org.apache.xmlbeans.impl.schema及下属所有impl子包，官方发布的xmlbeans 3.x OSGi Bundle默认仅导出公开API包，不包含内部实现类的导出权限，这是最常见的配置缺口
  • 检查org.apache.poi.ooxml.schemas（4.1.1版本）的Import-Package配置：确认其是否存在对org.apache.xmlbeans.*相关包的有效导入规则，从报错日志可判断当前Bundle完全缺失该包的导入声明
• 修正Bundle的包导入导出规则，不依赖Dynamic-import兜底
  避免给xmlbeans配置动态导入规则，针对性修正包暴露关系：
  • 针对xmlbeans 3.1.0的Bundle，在目标平台的Bundle定义配置中手动追加Export-Package规则，将org.apache.xmlbeans.impl.*下所有实现包设置为导出状态，匹配3.1.0的版本标识
  • 针对poi-ooxml-schemas 4.1.1的Bundle，手动追加Import-Package规则，强制导入org.apache.xmlbeans.impl.schema及所有关联的impl子包，将导入版本范围设置为覆盖3.1.0的兼容区间（如[3.1.0,4.0.0)）
• 排查类加载路径冲突
  清理目标平台的冗余依赖，避免类加载歧义：
  • 移除所有残留的xmlbeans 2.6.0依赖、非OSGi格式的裸xbean.jar包，杜绝类加载器从错误路径加载不匹配的实现类
  • 检查poi-ooxml核心Bundle的清单配置，确认其未内嵌打包xmlbeans实现类，避免类加载器优先加载Bundle内部捆绑的不匹配版本类
• 启动后验证类加载链路
  启动OSGi运行环境后，通过平台自带的Bundle诊断工具（如Equinox的bundle <poi-schemas的Bundle ID>命令）查看依赖解析状态：确认poi-ooxml-schemas Bundle已成功关联xmlbeans Bundle导出的SchemaTypeSystemImpl类，无未解析的导入包即可正常运行

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