PrimeFaces 13懒加载模型导出PDF为空文件问题求助

我使用PrimeFaces 13、Java 21，搭配PrimeFaces支持的最后一个com.lowagie.itext v2.1.7版本。目前csv、xls格式导出正常，但PDF导出时会下载一个0字节的空文件，且无任何报错。

相关代码如下：

<p:commandButton value="Export">
   <p:dataExporter type="pdf" target="table-id" fileName="myExportedPdf"/>
</p:commandButton>
                        
...

<p:dataTable id="table-id" var="data" value="#{ctrl.model}" reflow="true"
 multiViewState="true" draggableColumns="true" selection="#{ctrl.selection}"
 rowKey="#{data.id}" disabledSelection="#{data.disableSel}" paginator="true"
 paginatorTemplate="{CurrentPageReport}  {FirstPageLink} {PreviousPageLink} 
 {PageLinks}   {NextPageLink} {LastPageLink}" rowsPerPageTemplate="10,25,50"
 rows="10" rowSelectMode="add" paginatorPosition="bottom" lazy="true"
 sortBy="#{crtl.defaultSort}" stripedRows="true"
>

我已查阅PrimeFaces官方文档及官方示例，由于其他格式导出正常，怀疑是itext依赖（已过时）的问题，但升级该依赖会因导入路径从com.lowagie变为com.itext而出现ClassNotFound运行时错误。请问这是配置问题，还是PDF导出功能已不可用？

问题原因与解决方案 #

• 核心原因：PrimeFaces 13原生p:dataExporter的PDF导出依赖老旧的com.lowagie.itext v2.1.7，该版本与Java 21存在兼容性冲突——Java 21对反射、字节码操作的限制更严格，导致老旧itext无法正常生成PDF内容，最终输出空文件。
• 直接升级itext不可行的原因：PrimeFaces 13的PDF导出逻辑硬编码依赖com.lowagie包路径，直接替换为新版com.itext会触发类找不到错误，因为底层代码未适配新包名。

可行解决办法

1. 改用PrimeFaces Extensions导出组件
   PrimeFaces Extensions提供了基于新版iText 7的pe:exporter组件，完全兼容Java 21和PrimeFaces 13，无需依赖老旧com.lowagie包。替换原有代码即可：

   <p:commandButton value="Export">
       <pe:exporter type="pdf" target="table-id" fileName="myExportedPdf" />
   </p:commandButton>
   

   需引入对应PrimeFaces 13版本的PrimeFaces Extensions依赖。

2. 自定义PDF导出逻辑
   放弃原生p:dataExporter，自行基于新版iText 7编写导出代码：

   • 引入com.itextpdf相关依赖（如itextpdf、itext-layout）
   • 在后台Bean中实现数据读取、PDF生成逻辑，通过PrimeFaces的StreamedContent将文件输出到前端。

3. 临时降级Java版本（不推荐）
   若暂时无法更换组件或自定义逻辑，可尝试降级到Java 11或Java 8，老旧com.lowagie.itext v2.1.7在这些版本下可正常工作，但这只是权宜之计，不符合Java版本升级的长期趋势。

内容的提问来源于stack exchange，提问作者A.Casanova