使用wkhtmltopdf或pdfkit转换大型HTML为PDF仅输出1页内容不全如何解决

开发者阿泽

2026-9-25

解决方案

1. 修正HTML样式限制（最常见原因）

绝大多数单页截断问题都是HTML的全局样式限制导致的，检查是否给html、body或顶层容器设置了height: 100%、overflow: hidden这类强制内容高度等于一屏的属性，可在HTML中新增打印专属样式覆盖原有规则：

@media print {
  html, body {
    height: auto !important;
    overflow: visible !important;
  }
  /* 若有自定义顶层容器，同步修改其样式 */
  .root-container, #app {
    height: auto !important;
    overflow: visible !important;
  }
  /* 固定定位元素会导致内容重叠/截断，打印时改为普通流定位 */
  .fixed-nav, .fixed-footer {
    position: static !important;
  }
  /* 避免长表格、长段落被强制分页截断 */
  table, p, pre, img {
    page-break-inside: avoid;
  }
}

2. 调整wkhtmltopdf运行参数

添加核心参数适配长内容转换，两种使用场景的修改方式如下：

终端命令执行
修改后命令为：
```
wkhtmltopdf --print-media-type --disable-smart-shrinking --page-size A4 my_html_file.html my_pdf_file.pdf
```
参数说明：
- --print-media-type：强制使用打印媒体样式，匹配刚才新增的@media print规则
- --disable-smart-shrinking：禁用默认的智能内容缩放，避免内容被强制收缩到单页
- --page-size A4：明确指定页面尺寸为标准A4，避免默认尺寸适配异常

Python pdfkit调用
调用时传入对应options参数即可：

import pdfkit

options = {
    'page-size': 'A4',
    'disable-smart-shrinking': '',
    'print-media-type': '',
    'encoding': "UTF-8"
}

with open('my_html_file.html', encoding='utf-8') as f:
    pdfkit.from_file(f, 'my_pdf_file.pdf', options=options)