如何在Docker中正确手动安装并使用Python包bonsai？

问题根源 #

1. 直接复制bonsai文件夹到${LAMBDA_TASK_ROOT}无法被Python识别为合法模块：Python的模块搜索路径要求模块需正确安装到site-packages目录，或包结构严格符合导入规范——你的bonsai文件夹虽包含代码，但缺少安装步骤将其注册到Python环境。
2. 多阶段构建中用Ubuntu编译的模块与Lambda的Amazon Linux运行环境不兼容：_bonsai.cpython-311-x86_64-linux-gnu.so是Ubuntu环境编译生成的二进制文件，无法在Amazon Linux的Lambda镜像中正常加载。

正确的Dockerfile配置 #

直接在Lambda官方Python镜像中编译安装bonsai，确保模块与运行环境完全兼容：

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

# 安装编译bonsai所需的系统依赖（Amazon Linux使用yum包管理器）
RUN yum install -y gcc openldap-devel cyrus-sasl-devel && yum clean all

# 复制bonsai源码到容器临时目录
COPY bonsai /tmp/bonsai

# 通过pip安装本地的bonsai模块，自动处理setup.py流程
RUN pip install /tmp/bonsai

# 安装项目其他依赖
COPY requirements.txt ${LAMBDA_TASK_ROOT}
RUN pip install -r requirements.txt

# 复制Lambda函数代码到任务根目录
COPY lambda_function.py ${LAMBDA_TASK_ROOT}

# 设置Lambda函数启动入口
CMD [ "lambda_function.handler" ]

关键说明 #

• 系统依赖安装：Amazon Linux使用yum而非Ubuntu的apt，需安装gcc（编译C扩展）、openldap-devel和cyrus-sasl-devel（bonsai依赖的LDAP/SASL开发库）。
• 本地模块安装：pip install /tmp/bonsai会自动执行模块的setup.py，将bonsai正确安装到Python的site-packages目录，确保Python能正常识别并导入。
• 流程顺序优化：先安装系统依赖，再处理Python模块，避免编译时因缺少依赖导致失败。

验证步骤 #

1. 构建Docker镜像：

docker build -t lambda-bonsai .

2. 启动容器测试：

docker run -p 9000:8080 lambda-bonsai

3. 触发函数验证：

curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'

若不再出现No module named 'bonsai'错误，说明安装成功。

备选方案（无setup.py时） #

如果你的bonsai文件夹没有setup.py，可直接将其复制到Python的site-packages目录：

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

# 获取Python site-packages路径
RUN SITE_PACKAGES=$(python -c "import site; print(site.getsitepackages()[0])")

# 复制bonsai到Python模块搜索路径
COPY bonsai $SITE_PACKAGES/bonsai

# 安装其他依赖和函数代码
COPY requirements.txt ${LAMBDA_TASK_ROOT}
RUN pip install -r requirements.txt
COPY lambda_function.py ${LAMBDA_TASK_ROOT}

CMD [ "lambda_function.handler" ]

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