使用wkhtmltopdf PHP无法生成PDF第二页及多页转换异常问题

我之前也碰到过类似的坑，核心原因其实是pdftohtmlEx生成的HTML并没有自带严格的分页规则，而wkhtmltopdf是靠自己的排版逻辑拆分页面的，自然就会和原HTML（对应原PDF）的页数对不上。给你几个实操的解决方向：

1. 利用pdftohtmlEx的分页标记添加强制分页CSS #

先检查你生成的HTML结构，pdftohtmlEx通常会给每一页内容包裹一个带特定类名的容器（比如<div class="page">）。如果有这个结构，直接给HTML加以下CSS规则：

/* 给除最后一页外的所有页面容器添加强制分页 */
.page:not(:last-child) {
  page-break-after: always;
  page-break-inside: avoid;
}

这样wkhtmltopdf就会严格跟着原PDF的分页节点走，不会乱拆分页面。

2. 对齐wkhtmltopdf的页面参数与原PDF #

如果原PDF有特定的页面尺寸、边距，一定要让wkhtmltopdf的参数完全匹配，否则缩放或边距变化会直接导致页数偏差：

wkhtmltopdf --page-size A4 --margin-top 10mm --margin-bottom 10mm --margin-left 15mm --margin-right 15mm --disable-smart-shrinking input.html output.pdf

• --disable-smart-shrinking：禁用自动缩放逻辑，避免内容被压缩/拉伸打乱分页
• 所有尺寸参数要和原PDF完全一致，可以用PDF查看工具（比如Adobe Acrobat）查看原PDF的页面属性

3. 处理跨页元素的溢出问题 #

有时候HTML里的长文本、图片或表格会被wkhtmltopdf强制拆到两页，导致页数增加。可以给这些元素加CSS规则避免拆分：

img, table, .long-text-block {
  page-break-inside: avoid;
}

如果元素本身尺寸超过单页，就得手动调整大小，或者在合适的位置插入手动分页标记：

<div style="page-break-after: always;"></div>

4. 手动插入分页标记（如果pdftohtmlEx未生成分页容器） #

如果pdftohtmlEx的输出没按页拆分容器，你可以用脚本（比如Python的BeautifulSoup）分析HTML内容，找到原PDF分页的位置（比如根据内容高度、特定文本标记），手动插入分页节点。

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