Windows下Docker部署AWS Lambda Python调用wkhtmltopdf报错求助

这个问题的核心原因是AWS Lambda的运行环境是Linux（Amazon Linux 2/2023），你在Windows上构建的镜像和Lambda的系统环境完全不兼容。wkhtmltopdf依赖Qt的图形渲染库，Windows和Linux的底层图形接口、依赖库差异极大，你在Windows打包的wkhtmltopdf二进制文件或依赖，放到Lambda的Linux环境里根本无法正常初始化QPainter，直接导致报错。

具体解决步骤 #

1. 切换Linux构建环境
   用WSL2、本地Linux虚拟机、AWS EC2实例，或者CI/CD工具（比如GitHub Actions）来构建镜像，确保构建环境和Lambda运行环境一致。

2. 调整Dockerfile适配Linux环境
   基于Lambda官方的Python基础镜像，在镜像内安装Linux版的wkhtmltopdf及其依赖库，示例如下：

   # 使用Lambda官方Python 3.11镜像（对应你的Python版本）
   FROM public.ecr.aws/lambda/python:3.11
   
   # 安装wkhtmltopdf及必要依赖（Amazon Linux用yum）
   RUN yum update -y && yum install -y wkhtmltopdf libXrender libXext fontconfig libx11 openssl-libs
   
   # 复制你的Lambda代码到任务目录
   COPY app.py ${LAMBDA_TASK_ROOT}
   
   # 设置Lambda处理程序
   CMD ["app.lambda_handler"]
   

3. 修改Lambda代码调用逻辑
   不需要自己携带wkhtmltopdf二进制文件，直接调用系统安装的wkhtmltopdf命令。如果Lambda环境没有图形界面导致仍有问题，用xvfb-run模拟X11环境：

   import subprocess
   
   def lambda_handler(event, context):
       # 示例：用xvfb-run包装wkhtmltopdf命令
       cmd = ["xvfb-run", "wkhtmltopdf", "input.html", "output.pdf"]
       result = subprocess.run(cmd, capture_output=True, text=True)
       if result.returncode != 0:
           raise Exception(f"转换失败: {result.stderr}")
       # 后续处理PDF文件
       return {"statusCode": 200, "message": "PDF转换成功"}
   

额外排查点 #

如果切换Linux环境后仍报错，检查这些：

• 确认wkhtmltopdf版本和Amazon Linux兼容（优先用yum源里的版本，避免手动下载二进制文件）
• 检查HTML内容里的资源（比如图片、CSS）路径是否可访问，避免因资源加载失败导致渲染错误
• 确保Lambda函数有足够的内存（wkhtmltopdf渲染PDF需要一定内存，建议至少512MB）

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