将Google API Python库部署到AWS Lambda遇兼容性及层上传问题

1. AWS Lambda对Python 3.10的支持 #

AWS Lambda完全支持Python 3.10运行时，创建Lambda函数时可直接选择该版本，无需担心环境兼容性问题。

2. 库打包失败的核心原因 #

你直接从PyPI下载的库可能包含针对本地系统（如Windows/macOS）的编译二进制文件，而Lambda运行环境为Amazon Linux 2，跨平台的编译文件会导致依赖无法正常加载。这并非库版本不兼容，而是打包方式错误。

3. 正确打包Google依赖库到Lambda层的方法 #

方法一：在Amazon Linux环境中打包 #

可使用AWS Cloud9、EC2实例（选择Amazon Linux 2镜像）或本地Amazon Linux虚拟机执行以下步骤：

# 创建Lambda层要求的目录结构
mkdir -p python/lib/python3.10/site-packages

# 安装依赖到指定目录
pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib -t python/lib/python3.10/site-packages

# 压缩为层文件
zip -r google-sheets-libs.zip python

将生成的google-sheets-libs.zip上传为Lambda层即可。

方法二：用Docker模拟Lambda环境打包 #

若无Amazon Linux环境，可通过Docker模拟Lambda的Python 3.10运行环境：

# 拉取Lambda Python 3.10构建镜像并安装依赖
docker run -v "$PWD":/var/task public.ecr.aws/sam/build-python3.10:latest /bin/sh -c "
  mkdir -p python/lib/python3.10/site-packages &&
  pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib -t python/lib/python3.10/site-packages &&
  exit
"

# 压缩为层文件
zip -r google-sheets-libs.zip python

4. 版本兼容性说明 #

虽然google-auth-httplib2和google-auth-oauthlib未在PyPI明确标注支持Python 3.10，但它们的最新版本均兼容Python 3.7及以上版本（包括3.10），无需降级到旧版本。

额外注意事项 #

• Lambda层的目录结构必须严格遵循python/lib/pythonX.X/site-packages/格式，否则Lambda无法识别依赖。
• 确保Google Service Account密钥已正确配置（可存储在Lambda环境变量或AWS Secrets Manager中），且该账号已获得目标Google Sheet的访问权限（需在Google Sheet中共享给Service Account的邮箱）。

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