创建含python-ldap的Lambda层时wheel构建失败如何解决

python-ldap包含C语言扩展，安装时需要本地编译，编译过程依赖OpenLDAP、Cyrus SASL的系统级开发库头文件。你执行的命令没有提前在构建容器中安装这些系统依赖，gcc编译阶段找不到lber.h头文件，直接导致构建失败。

方案1：容器内预装编译依赖后安装 #

修改原docker命令，在执行pip安装前先通过yum安装所有编译必需的系统包，完整可直接执行的命令如下：

docker run -v "$PWD":/var/task "public.ecr.aws/sam/build-python3.9" /bin/sh -c "
yum install -y openldap-devel cyrus-sasl-devel;
/var/lang/bin/python3.9 -m pip install --upgrade pip;
pip install -r requirements.txt -t python/lib/python3.9/site-packages/;
exit"

• openldap-devel包会提供缺失的lber.h、ldap.h等OpenLDAP头文件，cyrus-sasl-devel提供SASL认证相关依赖头文件，二者是编译python-ldap的必需组件
• 基于官方SAM build镜像编译出的二进制文件和Lambda使用的Amazon Linux 2运行时完全兼容，不会出现运行时动态链接库找不到的问题

方案2：使用预编译wheel包跳过本地编译 #

不想安装编译依赖的话，可以强制pip下载官方预编译好的适配Linux环境的wheel包，跳过本地编译流程，命令如下：

docker run -v "$PWD":/var/task "public.ecr.aws/sam/build-python3.9" /bin/sh -c "
/var/lang/bin/python3.9 -m pip install --upgrade pip;
pip install --only-binary=:all: -r requirements.txt -t python/lib/python3.9/site-packages/;
exit"

• 参数--only-binary=:all:会强制pip只找预编译的二进制包，不执行本地编译，从根源上避免缺头文件的编译错误
• 该命令必须在SAM build容器内执行，不能直接在本地Mac/Windows/Ubuntu系统上运行，否则下载的wheel包和Lambda运行时环境不兼容，上传后会报导入错误

打包层之前可以先在容器内验证依赖可用性，避免上传后调用失败：

docker run -v "$PWD":/var/task "public.ecr.aws/sam/build-python3.9" /bin/sh -c "
PYTHONPATH=/var/task/python/lib/python3.9/site-packages /var/lang/bin/python3.9 -c 'import ldap; print(\"python-ldap import success, version:\", ldap.__version__)'
"

命令执行后正常输出版本号即代表依赖构建正常，将当前目录下生成的python目录打包为zip文件，即可直接作为Lambda层上传使用。

注意：Lambda运行时为Amazon Linux 2，所有包含C扩展的Python依赖都必须在同环境下编译打包，否则大概率出现运行时导入错误。

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