wkhtmltopdf 0.12.6页眉页脚间距失效且无显示问题排查

• 边距设置冲突：你将页面上下边距设为0mm，而wkhtmltopdf 0.12.6要求页眉/页脚必须有足够的顶部/底部边距空间才能渲染。当边距为0时，页眉页脚会被页面内容完全覆盖或直接不生成，旧版本对边距的校验逻辑更宽松，所以能正常显示。

• 间距参数缺少单位：header-spacing和footer-spacing参数在0.12.6版本中需要明确指定单位（如20mm），你代码里只写了数字，新版本无法识别默认单位，导致间距设置失效。旧版本可能默认使用像素或毫米作为单位，因此不受影响。

• 文件权限与SELinux限制：AlmaLinux 8.7默认启用SELinux强制模式，若/path/to/header.html和/path/to/footer.html的文件权限不足（比如web服务器用户无读取权限），或SELinux上下文配置错误，会导致wkhtmltopdf无法加载页眉页脚文件，进而不显示。切换版本后，二进制文件的运行用户可能变化，触发了之前未暴露的权限问题。

• 工具兼容性问题：mikehaertl的phpwkhtmltopdf可能未完全适配wkhtmltopdf 0.12.6的参数规范，部分参数的传递逻辑或命名映射存在偏差，导致页眉页脚相关配置未被正确解析执行。

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