AWS Lambda Python3.9部署firebase-admin遇google-cloud-firestore导入错误求助

核心问题分析 #

报错本质是依赖包不兼容或未正确安装：Lambda的运行环境架构（x86_64/arm64）可能和本地环境不一致，导致直接本地安装的二进制依赖包在Lambda中无法识别；或者仅安装grpcio无法满足google-cloud-firestore的完整依赖链。

具体解决步骤 #

方法1：匹配Lambda架构安装依赖（推荐） #

Lambda默认采用x86_64架构，若你选择了arm64，需对应安装适配架构的依赖：

• 若本地是x86_64系统，直接执行完整依赖安装命令：

  # 清空原有依赖目录，避免残留冲突包
  rm -rf ./*
  # 安装firebase-admin及所有关联依赖（包含google-cloud-firestore）
  pip install --target . firebase-admin google-cloud-firestore --platform manylinux2014_x86_64 --only-binary=:all:
  # 复制你的lambda_function.py到当前目录
  cp /path/to/your/lambda_function.py .
  # 打包ZIP（确保文件在根目录，不要嵌套）
  zip -r lambda-package.zip ./*
  

• 若本地是arm64系统（比如M系列Mac），需添加参数指定Lambda架构：

  pip install --target . firebase-admin google-cloud-firestore --platform manylinux2014_x86_64 --only-binary=:all: --python-version 3.9
  

方法2：用Docker模拟Lambda环境安装依赖 #

彻底规避架构不兼容问题：

1. 拉取Lambda Python 3.9官方镜像：

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

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

   docker run -v $(pwd):/app -w /app public.ecr.aws/lambda/python:3.9 pip install --target . firebase-admin google-cloud-firestore
   

3. 复制lambda_function.py到当前目录，打包ZIP后上传到Lambda。

方法3：使用Lambda层管理依赖 #

将依赖打包成层，复用性更高：

1. 创建Python层目录结构：

   mkdir -p python/lib/python3.9/site-packages
   cd python/lib/python3.9/site-packages
   

2. 安装依赖到该目录（用方法1或2的方式）：

   pip install --target . firebase-admin google-cloud-firestore [--platform参数按需添加]
   

3. 返回上级目录，打包成ZIP：

   cd ../../../../
   zip -r firestore-layer.zip python/
   

4. 在AWS控制台创建Lambda层，上传该ZIP，然后在你的Lambda函数中关联此层。

打包验证 #

上传前检查ZIP内容：确保lambda_function.py在根目录，且包含firebase_admin、google等依赖文件夹，无多余嵌套目录。

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