在Google Cloud Functions中安装Python版GDAL时部署出错求助

问题原因 #

pip安装GDAL时需要从源码编译，编译过程依赖系统级的libgdal-dev开发库和gdal-config工具，但Google Cloud Functions（GCF）默认Python运行时环境未预装这些依赖，导致编译失败并抛出FileNotFoundError: No such file or directory: 'gdal-config'错误。

可行修复方案 #

方案1：使用Cloud Build自定义构建步骤（推荐） #

通过Cloud Build自定义构建流程，先安装系统依赖再部署函数，无需修改现有函数代码：

1. 创建cloudbuild.yaml文件，内容如下：

steps:
# 安装系统依赖并预安装Python包
- name: 'python:3.9-bullseye'
  entrypoint: 'bash'
  args:
    - '-c'
    - |
      apt-get update && apt-get install -y libgdal-dev gdal-bin
      pip install --upgrade pip setuptools wheel
      pip install -r requirements.txt -t ./.python_packages/lib/python3.9/site-packages
# 部署Cloud Function
- name: 'gcr.io/cloud-builders/gcloud'
  args:
    - 'functions'
    - 'deploy'
    - 'YOUR_FUNCTION_NAME'  # 替换为你的函数名
    - '--runtime'
    - 'python39'
    - '--trigger-http'       # 根据你的触发器类型调整（如--trigger-topic）
    - '--source'
    - '.'
    - '--entry-point'
    - 'YOUR_FUNCTION_ENTRY'  # 替换为你的函数入口（如main）

2. 执行部署命令：

gcloud builds submit --config cloudbuild.yaml

方案2：使用预编译GDAL Wheel包 #

跳过源码编译，直接安装预编译的GDAL Wheel包，避免依赖系统编译工具：

修改requirements.txt，指定GDAL版本并强制使用预编译包：

numpy
pygrib
requests
google-cloud-storage
GDAL==3.4.3 --only-binary :all:

注意：需选择与GCF Python 3.9运行时（Debian 11）兼容的GDAL版本，建议选择3.4.x或更高的稳定版本。

方案3：迁移至Cloud Run（高自由度方案） #

若需要更多系统依赖或自定义环境，可迁移至Cloud Run，通过Docker镜像完全控制环境：

1. 创建Dockerfile：

FROM python:3.9-slim-bullseye

# 安装GDAL系统依赖
RUN apt-get update && apt-get install -y --no-install-recommends libgdal-dev gdal-bin \
    && rm -rf /var/lib/apt/lists/*

# 设置环境变量，让pip识别GDAL头文件
ENV CPLUS_INCLUDE_PATH=/usr/include/gdal
ENV C_INCLUDE_PATH=/usr/include/gdal

# 安装Python依赖
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制函数代码
COPY main.py .

# Cloud Run启动命令（假设你的函数入口是main函数，使用HTTP触发器）
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "$PORT"]

2. 构建并部署到Cloud Run：

gcloud builds submit --tag gcr.io/[PROJECT_ID]/gdal-function
gcloud run deploy gdal-function --image gcr.io/[PROJECT_ID]/gdal-function --platform managed

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