iText 7.2.0表格单元格文本不渲染且报Element does not fit current area警告如何解决

问题结论 #

这个问题是iText 7.2.0~7.2.3版本的原生bug，和代码编写逻辑无关。

问题原因 #

你使用了9等分的固定布局表格，每个单元格的可用宽度刚好卡在加粗样式下Description文本的渲染宽度临界值：

• iText 7.2.0版本对窄字符（比如小写i）的字宽计算存在浮点数精度误差，计算得到的Description文本宽度略大于单元格实际可用宽度
• 由于没有配置允许单词内拆分换行的规则，iText默认找不到合法换行点，同时单元格默认没有足够高度容纳两行内容，就会触发Element does not fit current area警告，直接丢弃整个单元格的内容不渲染
• 把小写i换成大写I后，字符总宽度的计算误差刚好落到可用宽度范围内，因此可以正常渲染

修复方案 #

可以根据项目约束选择以下任意一种方案：

方案1：升级iText版本（最推荐） #

这个精度问题已经在iText 7.2.4及后续版本修复，直接将iText依赖升级到7.2.4或更高版本即可解决，无需修改业务代码。

方案2：配置单词拆分规则（同时满足业务需求） #

你原本就要求允许在单词中间截断换行，只需在现有Style中增加拆分策略配置即可，就算文本宽度超出也会自动拆分换行，不会出现内容丢失：

// 修改Style定义，允许任意字符位置拆分换行
Style style = new Style()
        .setBold()
        .setSplitCharacters((text, glyphPos, linePos) -> true);

方案3：临时兼容调整 #

如果不能升级版本也不想修改拆分规则，可以做小幅度参数调整规避临界值问题：

• 小幅降低字号，比如给Style增加.setFontSize(11.5f)
• 小幅缩小单元格默认内边距，给Style增加.setPaddingLeft(1f).setPaddingRight(1f)
• 取消表格固定布局，或者调整列宽占比给每列多分配一点宽度

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