升级Apache POI依赖后部分方法无法找到的技术求助

核心问题分析 #

• 依赖冗余与冲突：同时引入poi-ooxml-full和poi-ooxml-lite会导致类路径冲突，这两个包是互斥的——前者包含完整OOXML schema类，后者是精简版，同时存在会让部分类/方法无法被正确加载。另外poi-ooxml和poi-ooxml-full功能重叠，重复引入也会引发依赖混乱。
• API迭代变更：POI从4.x升级到5.x，部分原ooxml-schemas中的类、方法被重构或迁移路径，直接替换依赖但未调整代码会出现找不到方法的情况。
• 依赖结构调整：POI 5.x开始拆分了原ooxml-schemas的内容，poi-ooxml-full已包含完整的schema实现，无需再搭配旧的schema依赖。

解决方案 #

1. 清理冗余依赖 #

保留必要依赖，移除冲突包，调整后的依赖配置如下：

implementation 'org.apache.poi:poi:5.2.3'
implementation 'org.apache.poi:poi-ooxml-full:5.2.3'
implementation 'org.apache.xmlbeans:xmlbeans:5.1.1'

说明：

• 移除poi-ooxml：poi-ooxml-full已包含其全部功能，重复引入会导致依赖冲突。
• 移除poi-ooxml-lite：与poi-ooxml-full互斥，按需选择其一即可，需完整功能则保留full版本。

2. 适配API变更 #

POI 5.x对部分底层schema API做了调整：

• 原ooxml-schemas中的CTXXX类，现在迁移到org.apache.poi.schemas.ooxml包下。
• 部分方法签名变更或被标记为过时，建议优先使用POI提供的高层封装API，减少对底层schema类的直接依赖，避免版本升级带来的适配问题。

3. 验证依赖树 #

用构建工具命令检查是否存在依赖冲突：

• Gradle：

./gradlew dependencies

• Maven：

mvn dependency:tree

若发现多版本POI或xmlbeans依赖，手动排除冗余的低版本依赖。

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