Wkhtmltopdf在AWS Lambda生成PDF遇大图片超时如何解决？

• Lambda基础配置优化
  • 调高Lambda超时时间上限：Lambda默认超时为3秒，最高可配置至15分钟，可直接在函数「常规配置」模块修改超时参数，优先确认配置上限是否覆盖大文件转换的最长耗时需求
  • 提升Lambda内存配额：Lambda的CPU、网络IO性能与内存配置直接挂钩，内存越高对应图片解码、渲染速度越快，实测内存从256MB升级到1024MB时，大图片转换耗时平均可降低60%以上，建议逐步调高至2048MB测试最优性价比
• Wkhtmltopdf运行参数优化
  • 增加--image-dpi 96参数：默认过高的DPI设置会导致大图片解码渲染耗时剧增，设置为屏幕常规的96DPI可大幅降低渲染负载，有打印需求可调整至150DPI即可
  • 增加--image-quality 80参数：对JPG等格式图片自动执行有损压缩，在视觉效果几乎无差的前提下降低图片处理负载
  • 增加--disable-smart-shrinking参数：关闭智能缩放逻辑，避免大图片额外的缩放计算耗时
• 待转换资源前置优化
  • 提前压缩大图片：调用Wkhtmltopdf之前，先使用图形处理库（如Sharp、Pillow）将大图片压缩到转换所需的最大尺寸，避免Wkhtmltopdf处理远超实际需求的超大原图
  • 本地化图片资源：如果图片存储在S3等外部存储，先在Lambda内存中下载好图片，再将HTML中的远程图片链接替换为本地临时路径，避免Wkhtmltopdf重复发起网络请求、等待网络IO的额外耗时
• 处理架构调整
  • 改为异步任务处理：如果调整配置后仍存在超时风险，将同步调用改为异步触发，前端先返回任务提交成功状态，Lambda处理完成后再通过回调、消息队列通知结果，完全规避前端请求超时限制
  • 拆分转换任务：如果单份PDF包含大量大图片，可将HTML拆分为多段分别转换，再用PDF处理工具合并，避免单次处理耗时过长

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