iText7与pdfHtml转HTML为PDF时page-break-inside: avoid样式失效求助

我之前在项目里也踩过这个版本组合的坑——确实，pdfHtml 2.0.2搭配iText7 7.1.2时，page-break-inside: avoid在<tbody>上的表现和其他HTML转PDF工具不一样，这是早期版本对表格元素样式解析的局限性导致的。下面给你几个可行的解决方案和原因分析：

一、最直接的 workaround：把样式移到<tr>上 #

这个版本的pdfHtml对表格行(<tr>)的分页控制支持比<tbody>稳定得多。你可以修改HTML流里的样式，把规则改成：

tr { page-break-inside: avoid; }

或者直接给每个<tr>加内联样式：

<tr style="page-break-inside: avoid;">

这种方法不用改任何转换器配置，大部分场景下都能解决tbody被拆分的问题。

二、配置转换器属性强制遵循分页规则 #

如果必须保留<tbody>上的样式，你可以通过ConverterProperties调整pdfHtml的表格处理逻辑：

1. 创建配置实例，设置表格布局策略为自动，并指定使用打印媒体类型（确保分页样式被正确应用）：

ConverterProperties properties = new ConverterProperties();
// 让pdfHtml自动适配表格布局，优先遵循CSS规则
properties.setTableLayoutPolicy(TableLayoutPolicy.AUTO);
// 指定媒体类型为打印，触发分页相关样式的解析
MediaDeviceDescription printMedia = new MediaDeviceDescription(MediaType.PRINT);
properties.setMediaDeviceDescription(printMedia);

2. 转换时传入这个配置：

HtmlConverter.convertToPdf(htmlInputStream, pdfOutputStream, properties);

这个配置会让pdfHtml更严格地解析<tbody>上的page-break-inside: avoid规则。

三、版本升级建议 #

如果你的项目允许，最好升级到pdfHtml 3.x+搭配iText7 7.2.x+的组合。新版本对CSS分页属性的支持全面了很多，不仅<tbody>，<thead>、<tfoot>这类容器的分页控制也能正常生效，不用再做这些额外的适配。

另外你提到输入是HTML流而非静态文件，这点完全不用担心——pdfHtml处理流和本地文件的逻辑是一致的，只要样式本身能被正确识别，就不会有问题。

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