wkhtmltopdf表格未正常分页跳转至下页问题求助

针对你遇到的wkhtmltopdf转换PDF时表格跳过当前页直接跳转至下一页的问题，结合你的CSS设置和场景，给出以下针对性解决方案：

1. 缩小全局break-inside: avoid的作用范围 #

当前.single-block *的全局设置会让所有子元素强制不允许内部拆分，包括表格本身，这会导致wkhtmltopdf认为整个表格不能拆分，一旦当前页剩余空间放不下完整表格，就直接推到下一页。修改CSS，只对非表格的块元素应用该规则：

.single-block > :not(table) {
    page-break-inside: avoid;
    break-inside: avoid;
}

2. 优化表格的分页规则 #

明确允许表格跨页拆分，仅保证单行不被拆分，调整表格相关CSS：

table {
    page-break-inside: auto;
    break-inside: auto;
}

table tr, table .tr {
    page-break-inside: avoid;
    break-inside: avoid;
    page-break-after: auto;
}

3. 修正元素高度计算偏差 #

添加box-sizing: border-box确保元素高度计算包含内边距和边框，避免wkhtmltopdf因高度计算错误导致分页判断失误：

.single-block, .single-block table {
    box-sizing: border-box;
}

4. 升级wkhtmltopdf版本 #

你使用的phpwkhtmltopdf 2.5对应的wkhtmltopdf版本可能较旧，旧版本对CSS分页属性的支持存在缺陷。建议升级到wkhtmltopdf 0.12.x系列的稳定版本，新版本对分页逻辑的处理更精准。

验证方法 #

修改上述CSS后，重新执行转换命令：

wkhtmltopdf https://kaingaora-pricelist.co.nz/pdf-test/display pdftest.pdf

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