Python使用wkhtmltopdf生成PDF时图片重叠，求可行解决方法

• 调整运行参数：调用时务必添加--disable-smart-shrinking参数禁用智能缩放，同时明确指定dpi参数，例如--dpi 96，页边距参数统一使用mm作为单位，避免单位不兼容导致的排版偏移。如果是使用pdfkit库，参数配置示例如下：

import pdfkit
options = {
    'disable-smart-shrinking': '',
    'dpi': '96',
    'margin-top': '10mm',
    'margin-right': '10mm',
    'margin-bottom': '10mm',
    'margin-left': '10mm',
    'encoding': "UTF-8"
}
pdfkit.from_file('input.html', 'output.pdf', options=options)

• 补充HTML全局CSS规则：在待转换的HTML头部加入以下CSS样式，从渲染规则层面避免重叠：

/* 避免图片、块级元素内部被分页拆分 */
img, div, p {
    page-break-inside: avoid !important;
}
/* 强制图片自适应容器宽度，避免超出页面导致挤压 */
img {
    max-width: 100% !important;
    height: auto !important;
    display: block;
}
/* 禁用溢出隐藏，避免跨页时内容被截断重叠 */
* {
    overflow: visible !important;
}

• 规避不兼容布局：HTML源码中尽量不要使用fixed、absolute定位，少用float浮动布局，优先使用flex或常规文档流布局，如果必须使用浮动，需要在浮动元素后添加清除浮动的规则，避免父容器高度塌陷导致的后续内容重叠。
• 跨页场景特殊处理：如果重叠出现在分页位置，可以在容易出现重叠的图片前手动添加强制分页标签<div style="page-break-before: always;"></div>，避免图片刚好卡在分页边界。
• 版本适配：确认使用的wkhtmltopdf版本为0.12.6及以上，旧版本对CSS的支持缺陷较多，容易出现未知排版问题。

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