使用LibreOffice Headless将HTML转PDF时图片不显示

我之前也碰到过类似的坑，LibreOffice的Headless模式在处理外部资源时确实有不少默认限制，给你几个实测有效的解决方案：

• 强制启用位图图像导出
  LibreOffice 6.0的PDF导出过滤器默认可能没开启远程图片加载，你可以在转换命令里明确指定导出参数，强制包含所有位图图像：

  soffice --headless --convert-to pdf:writer_pdf_Export:"ExportBitmapImages=true" --outdir ./output your-document.html
  

  这个参数会直接告诉Writer模块，导出PDF时必须加载并嵌入所有位图资源，包括你用HTTPS链接的远程图片。

• 验证远程图片的可访问性
  先确认运行Headless服务的服务器能正常访问你的图片URL。可以在服务器上用curl或wget测试下载图片，排查是否有防火墙拦截、代理配置错误或者SSL证书问题——如果是自签名证书，LibreOffice可能会拒绝加载，这时候要么把证书添加到系统信任库，要么临时禁用证书验证（不推荐生产环境用）。

• 改用本地图片路径
  如果远程加载始终卡壳，先把图片下载到本地，修改HTML里的src属性为本地相对路径（比如src="./path-to-image.jpg"）再转换。这种方法能彻底排除网络相关问题，适合测试或离线场景。

• 考虑升级LibreOffice版本
  LibreOffice 6.0是2018年的老版本了，后续的7.x版本修复了很多Headless模式下的资源加载bug。如果你的环境允许，升级到最新稳定版大概率能直接解决问题，还能获得更好的兼容性。

另外，从你给出的HTML结构来看，<img>标签的写法没问题，样式也没隐藏图片，所以重点还是放在上述几个方向排查就行。

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