使用wkhtmltopdf生成PDF时遭遇未捕获异常：SSL错误被忽略

先把你遇到的错误信息整理出来：

检测到未捕获异常，类型：Exception，消息：System error。页面加载进度（1/6）：[> ] 0% [> ] 10% [=> ] 12% 警告：SSL error ignored [> ] 14% [=> ] 16% [> ] 18% [> ] 20% [=> ] 23% [=> ] 25% [> ] 27% [=> ] 29% [> ] 31% [===...

我之前也踩过wkhtmltopdf的这类坑，结合你的错误日志，给你几个针对性的排查和解决方向：

• 优先处理SSL证书问题：日志里的“SSL error ignored”是关键信号，大概率是目标页面的SSL证书不被wkhtmltopdf信任导致加载阻塞。你可以在命令里添加这些参数：

  • --ignore-ssl-errors：直接忽略所有SSL错误（适合测试环境）
  • --ssl-protocol=TLSv1.2：指定兼容的SSL协议版本（有些旧版本默认协议太老，和服务器不匹配）
  • 如果是内部自签证书，可以用--ssl-ca-path /path/to/your/cert.pem指定信任的证书路径
    示例命令：wkhtmltopdf --ignore-ssl-errors --ssl-protocol=TLSv1.2 https://your-target-url.com output.pdf

• 解决页面加载阻塞问题：进度卡在31%左右，说明页面有资源加载超时或者渲染阻塞的情况：

  • 添加超时参数：--timeout 60000（设置60秒超时，避免因个别资源加载慢导致崩溃）
  • 如果页面依赖JS渲染但渲染不完整，加--javascript-delay 5000（给JS留5秒时间完成渲染）；如果不需要JS，直接用--disable-javascript跳过JS加载
  • 还可以用--disable-images测试是否是图片加载导致的问题，排除后再针对性处理图片资源

• 检查系统权限与路径：“System error”也可能是权限问题导致的：

  • 确认输出PDF的路径有写入权限，比如不要直接写到系统根目录或者受保护的文件夹
  • 检查输入的HTML文件/URL是否可访问，运行wkhtmltopdf的用户是否有读取权限

• 升级或更换wkhtmltopdf版本：有些旧版本的wkhtmltopdf对现代HTML/CSS特性支持差，或者SSL协议兼容有问题。建议升级到官方最新稳定版，如果你用的是Linux发行版自带的简化版，试试下载带完整QT环境的版本（很多发行版的包是裁剪过的，功能不全）

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