如何在Lucee 5.3.10.97中将Apache POI从2.5.1升级至3.17？

不建议直接替换Lucee内置的Apache POI 2.5.1 JAR文件，原因如下：

• 核心依赖冲突：Lucee的部分内置功能（如<cfspreadsheet>标签、文档解析工具）基于POI 2.5.1的API开发，直接替换为3.17版本会因API变更（方法废弃、类结构调整）导致这些核心功能崩溃，出现NoClassDefFoundError或NoSuchMethodError等异常。
• 版本兼容性断层：POI 2.5.1到3.17跨度极大，涉及大量底层实现重构，两者API兼容性极低，强行替换会破坏Lucee的稳定运行。

正确的升级方案是通过应用级或扩展级加载新POI版本，而非替换核心JAR：

1. 应用级加载（推荐）
   将POI 3.17的完整依赖包（包括poi-3.17.jar、poi-ooxml-3.17.jar、poi-ooxml-schemas-3.17.jar等所有关联JAR）放到你的CFML应用的WEB-INF/lib目录下。Lucee的类加载器会优先加载应用目录内的类，这样你的应用代码会使用3.17版本，而Lucee核心功能仍依赖内置的2.5.1版本，互不干扰。
2. 全局扩展级加载
   如果需要多个应用共用POI 3.17，可将所有依赖JAR放到Lucee安装目录的lib/ext文件夹。该目录的类会在核心类之后加载，需注意测试核心功能是否受影响，若出现冲突则回退到应用级加载方案。

注意事项 #

• 操作前务必备份Lucee核心lib目录，以便出现问题时快速回滚。
• 升级后需全面测试：包括你的应用中所有使用POI的代码，以及Lucee内置的文档处理相关功能，确保无兼容性异常。

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