使用Zappa部署AWS Lambda时遇Numpy ImportError问题求助

核心问题分析 #

你遇到的numpy.core._multiarray_umath找不到的错误，本质是本地编译的NumPy C扩展与AWS Lambda的Amazon Linux运行环境不兼容，再结合新增的私有GitHub依赖包，导致Zappa打包时依赖层级混乱，无法正确加载NumPy核心模块。

针对性解决方案 #

1. 使用Lambda Layers托管编译兼容的依赖 #

Lambda Layers可单独管理依赖包，避开本地与Lambda环境的编译差异，步骤如下：

• 模拟Lambda环境编译依赖：
  用Docker拉取Lambda官方镜像，在容器内创建虚拟环境并安装依赖：

  docker run -it --rm public.ecr.aws/lambda/python:3.8 bash
  python -m venv /opt/venv
  source /opt/venv/bin/activate
  # 安装指定版本NumPy和私有GitHub包
  pip install numpy==1.23.3 git+https://github.com/你的账号/私有仓库名.git
  # 整理依赖到Layer标准目录结构
  mkdir -p /opt/python/lib/python3.8/site-packages
  cp -r /opt/venv/lib/python3.8/site-packages/* /opt/python/lib/python3.8/site-packages/
  

• 打包并上传Layer：
  将/opt/python目录打包为zip文件，通过AWS控制台或CLI上传为Lambda Layer，记录Layer的ARN。
• 在Zappa中引用Layer：
  修改zappa_settings.json，添加Layer ARN并排除本地依赖：

  {
    "dev": {
      "aws_region": "你的AWS区域",
      "lambda_layer_arns": ["你的Layer ARN"],
      "exclude": ["numpy/", "私有包名称/"]
    }
  }
  

2. 调整私有依赖配置 #

检查私有GitHub包的setup.py或pyproject.toml：

• 确保NumPy版本约束与1.23.3匹配，避免依赖冲突
• 若私有包无需在安装时编译NumPy，可将其设为runtime_requires而非install_requires，减少打包层级问题

3. 重新部署前的清理步骤 #

• 删除本地虚拟环境，重新创建后仅安装业务代码（NumPy和私有包通过Layer加载）
• 部署前执行zappa clean清理旧打包缓存，再运行zappa update dev

验证方法 #

部署完成后，在Lambda控制台测试函数，查看日志是否仍有_multiarray_umath相关错误；若问题持续，检查Layer结构：确保zip包内依赖位于python/lib/python3.8/site-packages/路径下，且是基于Python3.8的Lambda环境编译。

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