AWS环境中Python导入GDAL为Lambda Layer失败，求解决方法

核心原因 #

Lambda运行在Amazon Linux 2（或Amazon Linux）环境中，本地直接安装的GDAL wheel文件依赖的系统库与Lambda环境不匹配，导致底层_gdal扩展无法加载；直接执行pip install gdal失败，是因为缺少GDAL系统开发库（如libgdal-dev）。

正确安装步骤 #

方法1：使用Lambda兼容的GDAL Wheel文件 #

• 选择与Lambda Python版本、系统架构完全匹配的预编译wheel文件（必须是适配Amazon Linux的版本，而非Windows/macOS版本）。
• 创建Lambda Layer要求的目录结构，并安装GDAL：

  mkdir -p python
  pip install [适配的GDAL Wheel文件路径] -t python/
  

• 将python目录打包为zip：

  zip -r gdal-layer.zip python/
  

• 在AWS控制台上传该zip作为Lambda Layer，并关联到目标函数。

方法2：在Amazon Linux环境编译GDAL（兼容性最优） #

Lambda运行环境基于Amazon Linux，直接在同环境编译可彻底避免依赖问题：

1. 启动Amazon Linux 2 EC2实例，或使用AWS CloudShell（原生基于Amazon Linux 2）。
2. 安装系统依赖：

   sudo yum install -y gcc gcc-c++ python3-devel gdal-devel gdal
   

3. 设置环境变量，让pip识别GDAL系统库：

   export CPLUS_INCLUDE_PATH=/usr/include/gdal
   export C_INCLUDE_PATH=/usr/include/gdal
   

4. 创建Layer目录并安装对应版本的GDAL：

   mkdir -p python
   pip3 install gdal==[系统gdal-devel对应版本号] -t python/ --no-cache-dir
   

   注意：必须安装与系统gdal-devel版本一致的GDAL包，例如系统装的是GDAL 3.0.4，则执行pip3 install gdal==3.0.4
5. 打包zip文件：

   zip -r gdal-layer.zip python/
   

6. 上传zip到Lambda Layer并关联函数。

方法3：用Docker模拟Lambda环境编译 #

无需EC2/CloudShell，用Lambda官方镜像模拟环境：

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

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

2. 启动容器并挂载本地目录：

   docker run -it --rm -v $(pwd):/app public.ecr.aws/lambda/python:3.9 bash
   

3. 在容器内安装依赖并编译GDAL：

   yum install -y gcc gcc-c++ python3-devel gdal-devel gdal
   export CPLUS_INCLUDE_PATH=/usr/include/gdal
   export C_INCLUDE_PATH=/usr/include/gdal
   mkdir -p /app/python
   pip3 install gdal==[对应版本] -t /app/python/ --no-cache-dir
   

4. 退出容器后，本地会生成python目录，打包zip上传即可。

验证操作 #

创建测试Lambda函数，验证GDAL导入：

import osgeo.gdal

def lambda_handler(event, context):
    return f"GDAL version: {osgeo.gdal.__version__}"

关联Layer后运行测试，若返回GDAL版本号则配置成功。

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