PrimeFaces项目中使用DataExporter组件导出Excel报错问题解析

问题背景

在PrimeFaces项目从5.x版本升级到15.x版本的过程中，开发人员遇到了使用DataExporter组件导出Excel文件时出现的异常问题。错误信息显示为"jakarta.servlet.ServletException: org.apache.poi.POIXMLException: java.lang.reflect.InvocationTargetException"。

错误分析

从错误堆栈中可以发现，核心问题出现在Apache POI库的调用过程中。具体错误是"java.lang.NoSuchMethodError: 'org.openxmlformats.schemas.spreadsheetml.x2006.main.CTIntProperty org.openxmlformats.schemas.spreadsheetml.x2006.main.CTFont.addNewFamily()'"。

这个错误表明：

1. 运行时环境中存在POI相关库的版本冲突
2. 某些POI依赖库版本不兼容
3. 项目中可能存在多个不同版本的POI库同时被加载

解决方案

经过技术专家的分析，正确的解决方法是：

1. 简化依赖：只需要保留poi-ooxml一个依赖项即可，其他相关依赖会被自动引入
2. 版本统一：确保所有POI相关库使用相同版本

正确的Maven依赖配置应该是：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.4.0</version>
</dependency>

需要移除以下不必要的依赖：

• poi
• ooxml-schemas
• xmlbeans

技术原理

这个问题的根本原因是类加载冲突。当项目中存在多个版本的POI库时，JVM可能会加载错误的类版本，导致方法签名不匹配。具体到这个问题：

1. XSSFFont类尝试调用CTFont.addNewFamily()方法
2. 但运行时加载的CTFont类版本不包含这个方法
3. 这是因为项目中混用了不同版本的POI相关库

最佳实践

1. 依赖管理：在Maven项目中，应该让Maven自动管理传递依赖，避免手动指定所有相关库
2. 版本检查：使用Maven的dependency:tree命令检查依赖树，确保没有版本冲突
3. 最小依赖：只声明必要的顶级依赖，让构建工具处理传递依赖

总结

在升级PrimeFaces版本时，特别是涉及到数据导出功能时，需要特别注意POI库的版本兼容性。通过简化依赖配置，只保留必要的poi-ooxml依赖，可以避免大多数版本冲突问题。如果问题仍然存在，建议创建一个最小可复现的测试项目来进一步排查问题。