Windows/Mac下用pip为AWS Lambda跨平台安装Python依赖遇阻

问题梳理 #

你在Windows（pip 22.3.1）或Mac环境下，给运行于Linux系统的AWS Lambda（Python 3.9）准备依赖包时，遇到pip参数约束的一系列问题：

• 执行命令 pip install -r requirements.txt --target .\lib --platform linux --python-version 3.9 时，被提示不能同时使用--user和--target，但你并未添加--user，需手动追加--no-user参数
• 添加--no-user后，又被要求必须搭配--no-deps或--only-binary=:all:：
  • 使用--only-binary=:all:时，安装jinja2==3.1.2会报错找不到适配的MarkupSafe（实际是参数不全导致pip未识别到对应二进制包）
  • 使用--no-deps时，需手动把所有子依赖添加到requirements.txt，维护成本极高

可行解决方案 #

方案1：补全pip平台参数，解决二进制包匹配问题 #

MarkupSafe有适配Linux的二进制包，之前报错是因为参数缺失，没有指定Lambda对应的具体平台架构和Python实现细节。完整的pip命令如下：

pip install -r requirements.txt --target ./lib \
  --platform manylinux2014_x86_64 \
  --python-version 39 \
  --implementation cp \
  --abi cp39 \
  --no-user \
  --only-binary=:all: \
  --no-cache-dir

• manylinux2014_x86_64是x86_64架构AWS Lambda对应的标准平台标签
• --implementation cp指定使用CPython（Lambda默认用CPython）
• --abi cp39对应Python 3.9的ABI版本
• 补全参数后，pip会拉取完全适配Lambda环境的二进制包，包括MarkupSafe的对应版本

方案2：用Docker模拟Lambda环境安装（最可靠） #

直接在和Lambda一致的Amazon Linux 2环境中安装依赖，彻底规避跨平台兼容问题：

1. 拉取Lambda对应的Python 3.9镜像：

docker pull public.ecr.aws/lambda/python:3.9

2. 运行容器，挂载本地目录并安装依赖：

docker run --rm -v "$(pwd):/workdir" -w /workdir public.ecr.aws/lambda/python:3.9 \
  pip install -r requirements.txt --target ./lib

• 此方法直接在Lambda同款环境中安装依赖，所有包原生适配，无需纠结pip跨平台参数
• 若使用ARM架构的Lambda，替换镜像为public.ecr.aws/lambda/python:3.9-arm64

方案3：用pip-tools自动管理依赖（适配--no-deps场景） #

如果坚持使用--no-deps，可以用pip-tools自动生成包含所有子依赖的requirements文件：

1. 安装pip-tools：

pip install pip-tools

2. 将你的基础依赖写入requirements.in（比如仅写入jinja2==3.1.2）
3. 生成包含所有依赖的完整requirements.txt：

pip-compile requirements.in

4. 执行安装命令：

pip install -r requirements.txt --target ./lib --platform manylinux2014_x86_64 --python-version 39 --implementation cp --abi cp39 --no-user --no-deps

• 无需手动添加子依赖，pip-tools会自动解析并生成完整依赖列表

总结 #

优先推荐Docker方案，它完全规避了pip跨平台参数的繁琐限制，确保依赖和Lambda环境100%兼容；如果不想用Docker，补全pip的平台参数也能解决二进制包匹配问题。

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