OpenPDF/iText PDF 杂乱线条问题彻底解决总结

OpenPDF/iText PDF 杂乱线条问题彻底解决总结

1. 问题现象

PDF中出现“杂乱线条/斜线”，总是在折线图下方、表格上方的固定位置。
代码已设置所有表格边框、宽度、自动换行，但线条依然存在。

2. 排查与分析过程

初步排查：

检查所有表格、单元格边框设置，确认无内容溢出、无负padding、无合并单元格异常。
优化表格宽度（95%）、自动换行，问题依旧。

深入分析：

发现线条总是出现在“图片（折线图）和表格交界处”，且与页面边界对齐。
怀疑是图片与表格之间未分隔，OpenPDF渲染时自动补全边框或溢出警告线。
进一步缩小图片宽度，插入多行空行，彻底分隔图片和表格。

3. 关键解决措施

折线图图片宽度缩小：
lineImg.scaleToFit(520, 180);，避免图片紧贴页面边界。

图片和表格之间插入多行空行：
document.add(Chunk.NEWLINE); 多次，确保图片和表格不会重叠或拼接。
表格宽度设置为95%，防止超出页面导致渲染异常。
所有单元格允许自动换行，防止内容溢出。

4. 结果

杂乱线条问题彻底消失，PDF视觉效果干净整洁。
证明OpenPDF在图片和表格交界处若无足够间隔，极易渲染出多余线条。
5. 经验教训
PDF中图片和表格交界处务必插入足够空行或段落，避免渲染重叠。
图片宽度不要紧贴页面边界，表格宽度也要适当缩小。
出现“固定位置杂乱线条”时，优先考虑内容块之间的物理分隔。
最终结论：

OpenPDF/iText生成PDF时，图片和表格之间如无足够间隔，极易出现杂乱线条。只需缩小图片宽度并插入多行空行即可彻底解决。

还有就是使用edge打开有无效线条，但是WPS打开却没有，可能是浏览器缓存或者是浏览器兼容性问题