使用PDFkit与Wkhtmltopdf生成PDF时表格整页跳移问题求助

先看你提供的CSS代码，第一行有个多余的闭合括号}，这会导致后续的表格样式全部失效，这大概率是问题根源之一，先修正这个错误。

以下是几个针对性的解决步骤：

• 修正并优化CSS样式
  替换成完整且正确的分页样式，确保表格能正常跨页：

  /* 全局容器不要强制避免分页 */
  .container {
    page-break-inside: auto;
  }
  table {
    width: 100% !important; /* 确保表格适配页面宽度 */
    page-break-inside: auto !important;
    border-collapse: collapse !important; /* 避免跨页时边框断裂 */
  }
  tr {
    page-break-inside: avoid !important;
    page-break-after: auto !important;
  }
  thead {
    display: table-header-group !important; /* 让表头在每页重复显示 */
  }
  tfoot {
    display: table-footer-group !important;
  }
  td, th {
    padding: 8px !important;
    word-wrap: break-word !important; /* 内容过长自动换行，避免撑宽表格 */
  }
  

• 调整Wkhtmltopdf的生成参数
  在PDFkit的配置里添加以下参数，优化渲染行为：

  options = {
      'page-size': 'A4',
      'margin-top': '10mm',
      'margin-right': '10mm',
      'margin-bottom': '10mm',
      'margin-left': '10mm',
      'enable-local-file-access': '',
      'no-outline': None,
      'encoding': "UTF-8",
      'disable-smart-shrinking': ''  # 禁用智能缩放，避免布局错乱
  }
  pdfkit.from_string(html_content, output_file, options=options)
  

• 检查表格父容器样式
  确保表格的父元素（比如div、section）没有设置page-break-inside: avoid或者position: absolute这类会干扰分页的样式，这些属性会让wkhtmltopdf把整个容器视为不可分割的块，从而把表格整体推到下一页。

• 排查内容高度问题
  如果表格里的单元格设置了固定高度，或者包含高尺寸图片，可能会导致表格总高度刚好超过一页阈值，建议把固定高度改成min-height，图片设置max-width: 100%，让内容自适应页面空间。

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