如何在AEM 6.3中更新Apache POI库OSGi包装器的POI版本至5.2.3？

步骤1：移除旧版本POI包 #

• 登录AEM的Felix控制台（路径：/system/console/bundles），搜索“OSGi Bundle Wrapper For The Apache POI Library”，找到对应包后先停止，再执行卸载操作。
• 卸载前建议查看该包的依赖关系（Felix控制台的“Dependencies”标签），确认依赖它的其他服务暂时不会出现运行异常，或者提前做好备份。

步骤2：获取适配OSGi的POI 5.2.3包 #

• 无需手动打包，直接使用社区或官方维护的OSGi化POI 5.2.3包集合，需包含poi、poi-ooxml、poi-scratchpad等核心模块的独立OSGi bundle，且每个bundle的MANIFEST.MF配置需适配AEM 6.3的OSGi环境，避免出现导入/导出包冲突。

步骤3：安装新版本POI包 #

• 登录AEM包管理器（路径：/crx/packmgr），将所有POI 5.2.3的OSGi包逐一上传并安装；也可将这些bundle打包成一个组合包，一次性完成安装。
• 安装完成后回到Felix控制台，确认所有POI相关bundle的状态为Active。

步骤4：验证升级效果 #

• 编写简单的测试代码（例如在自定义Servlet或组件中），调用POI 5.2.3的API（如读取/生成Excel文件），检查是否存在ClassNotFoundException或NoClassDefFoundError等异常。
• 测试AEM内置的依赖POI的功能（如报表导出），确保兼容性正常。

注意事项 #

• 若出现依赖冲突，可在Felix控制台的“Package Admin”中调整包的导入优先级，或在相关bundle的配置中添加DynamicImport-Package: *临时解决，但优先选择适配AEM 6.3的POI OSGi包。
• 升级前建议在测试环境验证，避免影响生产环境。

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