在AWS Lambda Layer部署WeasyPrint和Jinja2遇GTK3依赖问题求解决

WeasyPrint依赖GTK3及一系列系统库，而Lambda默认运行环境缺少这些组件，以下是三种可行的解决方案：

方案1：使用预编译的社区Layer（推荐） #

社区已经有针对Lambda环境预构建好的WeasyPrint Layer，包含所有必要的系统依赖和Python包，步骤如下：

• 选择与你的Lambda Python版本（如3.8）匹配的预编译ZIP包
• 将该ZIP上传为Lambda Layer，同时确保Jinja2已包含在Layer或函数代码中
• 在Lambda函数配置中关联该Layer，测试WeasyPrint导入功能

方案2：手动构建包含系统依赖的Layer #

需要在与Lambda一致的Amazon Linux 2环境中编译并打包所有依赖：

1. 启动Amazon Linux 2 EC2实例或使用Docker镜像amazonlinux:2
2. 安装编译工具和系统依赖：

sudo yum install -y gcc gcc-c++ make pkg-config python3-devel \
    gtk3-devel cairo-devel pango-devel gdk-pixbuf2-devel \
    libjpeg-turbo-devel libpng-devel libtiff-devel

3. 创建虚拟环境并安装Python包：

python3 -m venv venv
source venv/bin/activate
pip install weasyprint jinja2

4. 收集依赖到Layer目录：

mkdir -p layer/lib/python3.8/site-packages
mkdir -p layer/lib64

# 复制Python包
cp -r venv/lib/python3.8/site-packages/* layer/lib/python3.8/site-packages/

# 复制WeasyPrint依赖的系统库
ldd venv/lib/python3.8/site-packages/weasyprint/*.so | grep -o '/lib64/.*\.so.*' | sort -u | xargs cp -t layer/lib64/

5. 打包Layer：

cd layer
zip -r weasyprint-layer.zip .

6. 上传ZIP作为Lambda Layer并关联到函数

方案3：使用Lambda容器镜像 #

通过容器镜像直接包含所有依赖，无需Layer：

1. 创建Dockerfile：

FROM public.ecr.aws/lambda/python:3.8

# 安装GTK3系统依赖
RUN yum install -y gtk3 cairo pango gdk-pixbuf2 && \
    yum clean all

# 安装Python包
COPY requirements.txt .
RUN pip install -r requirements.txt --target "${LAMBDA_TASK_ROOT}"

# 复制Lambda函数代码
COPY lambda_function.py ${LAMBDA_TASK_ROOT}

CMD ["lambda_function.lambda_handler"]

2. 创建requirements.txt：

weasyprint
jinja2

3. 构建镜像并推送到Amazon ECR，然后创建使用该镜像的Lambda函数

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