使用Docker、Lambda层部署AWS Lambda函数时遇ImportError问题

以下是针对你遇到的「无法从Numpy源码目录导入」错误的具体解决思路：

1. 修正Lambda层的依赖打包结构 #

Lambda层要求Python依赖必须放在**python/lib/pythonX.X/site-packages**目录下（X.X对应你使用的Lambda Python运行时版本，如3.9）。若打包时直接复制Numpy源码目录，就会触发该错误。正确做法是用pip将依赖安装到指定目录后再打包：

# 安装依赖到符合Lambda层要求的目录
pip install numpy pandas -t ./python/lib/python3.9/site-packages \
  --platform manylinux2014_x86_64 \
  --only-binary=:all:

# 将python目录打包为层的zip文件
zip -r pandas_layer.zip python/

这样打包的是编译好的二进制依赖包，而非源码目录。

2. 检查Docker镜像构建逻辑 #

若使用Docker构建Lambda镜像，需确保依赖安装在Lambda运行时的正确路径，避免复制本地Numpy源码目录。示例Dockerfile片段：

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

# 安装依赖到Lambda任务根目录
COPY requirements.txt .
RUN pip install -r requirements.txt -t ${LAMBDA_TASK_ROOT}

# 复制函数代码
COPY handler.py ${LAMBDA_TASK_ROOT}

CMD ["handler.lambda_handler"]

如果结合Lambda层使用，需确认层的挂载路径不会与函数目录的源码产生冲突。

3. 验证Terraform层部署配置 #

检查Terraform中aws_lambda_layer_version的配置，确保打包的zip文件结构符合要求，无多余源码目录：

resource "aws_lambda_layer_version" "pandas_layer" {
  filename           = "pandas_layer.zip"
  layer_name         = "pandas-layer"
  compatible_runtimes = ["python3.9"]
  source_code_hash   = filebase64sha256("pandas_layer.zip")
}

同时确认Lambda函数关联层的顺序正确，避免依赖覆盖问题。

4. 在兼容环境中构建依赖 #

Lambda运行时基于Amazon Linux 2，本地直接安装的依赖可能因系统差异包含源码文件。建议用Docker在Amazon Linux 2容器内构建依赖：

# 用Lambda基础镜像临时构建依赖目录
docker run --rm -v "$PWD":/var/task public.ecr.aws/lambda/python:3.9 \
  pip install numpy pandas -t ./python/lib/python3.9/site-packages

再基于这个目录打包Lambda层。

5. 排查函数代码的路径修改 #

检查函数代码中是否有修改sys.path的逻辑，避免因路径调整导致Python误导入Numpy源码目录。例如不要随意将当前目录的父路径添加到sys.path中。

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