Azure Functions Linux环境Python3.11下GDAL安装替代方案咨询

方案一：通过系统包管理器预安装依赖后编译Python绑定 #

Azure Functions的Linux运行时基于Ubuntu，可直接通过系统包安装GDAL核心库，再让pip编译Python绑定：

• 在项目根目录创建requirements.sh脚本，内容如下：

apt-get update && apt-get install -y gdal-bin libgdal-dev python3.11-dev

• 在local.settings.json中添加环境变量，指定GDAL的头文件和库路径：

{
  "Values": {
    "C_INCLUDE_PATH": "/usr/include/gdal",
    "LIBRARY_PATH": "/usr/lib/x86_64-linux-gnu",
    "PYTHONPATH": "/usr/lib/python3/dist-packages"
  }
}

• 修改requirements.txt，仅保留gdal（需确保与系统安装的GDAL版本一致，可通过gdal-config --version查询后指定具体版本，如gdal==3.4.1）

方案二：使用自定义Docker镜像部署 #

通过自定义镜像完全控制环境构建，避免依赖缺失问题：

• 创建Dockerfile，基于Azure Functions Python 3.11官方镜像：

FROM mcr.microsoft.com/azure-functions/python:4-python3.11

ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

# 安装GDAL系统依赖及Python绑定
RUN apt-get update && apt-get install -y gdal-bin libgdal-dev python3.11-dev \
    && pip install gdal==$(gdal-config --version)

# 安装项目其他依赖
COPY requirements.txt /
RUN pip install -r /requirements.txt

# 复制项目代码
COPY . /home/site/wwwroot

• 使用Azure CLI将自定义镜像推送到Azure容器注册表，再部署到Azure Functions

方案三：自行编译适配Python 3.11的GDAL Wheel包 #

在与Azure Functions Linux环境一致的Ubuntu系统中编译轮子，再用于项目：

• 在Ubuntu 22.04环境中安装依赖：

apt-get update && apt-get install -y gdal-bin libgdal-dev python3.11-dev python3-pip

• 编译GDAL Wheel包：

pip wheel gdal==$(gdal-config --version)

• 将生成的.whl文件复制到项目目录，修改requirements.txt指向该文件（如./gdal-3.4.1-cp311-cp311-linux_x86_64.whl）

注意事项 #

• 确保GDAL系统库版本与Python绑定版本完全一致，否则会出现兼容性错误
• 使用自定义镜像时，需确认Azure Functions已配置为使用容器部署模式

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