Azure Functions Python v2消耗计划下gcc/libpq库安装问题求助

针对你在Azure Functions Python v2消耗计划中遇到的依赖库安装问题，提供以下几种可行方案：

方案1：使用预编译的PostgreSQL Python客户端库 #

这是最简便的解决方案，无需在服务器端安装任何系统库：

• 将requirements.txt中的psycopg2替换为psycopg2-binary（或其他预编译的PostgreSQL客户端包）
• 预编译包已经包含了所需的底层依赖，直接通过pip install即可完成安装，无需依赖服务器端的gcc和libpq

方案2：基于自定义Docker镜像部署消耗计划 #

消耗计划支持自定义容器部署，可预先将依赖库打包进镜像：

• 编写Dockerfile，基于官方Azure Functions Python v2镜像，提前安装gcc和libpq-dev：

FROM mcr.microsoft.com/azure-functions/python:4-python3.11
ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    AzureFunctionsJobHost__Logging__Console__IsEnabled=true

# 安装系统依赖
RUN apt-get update && apt-get install -y gcc libpq-dev && rm -rf /var/lib/apt/lists/*

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

# 复制函数代码
COPY . /home/site/wwwroot/

• 构建镜像并推送到Azure Container Registry，之后在消耗计划下使用该镜像部署函数应用，每次实例启动都会自带所需依赖，不会因重启丢失。

方案3：通过启动脚本自动安装依赖 #

利用函数应用的启动钩子，在实例启动时自动安装依赖：

• 禁用WEBSITE_RUN_FROM_PACKAGE配置（设置为0），确保文件系统可写
• 在函数根目录创建startup.sh脚本：

apt-get update && apt-get install -y gcc libpq-dev

• 在函数应用配置中添加WEBSITE_STARTUP_COMMAND，值为./startup.sh
• 该方案会在每次实例冷启动时自动执行安装，缺点是会增加冷启动时间，但能保证依赖存在。

方案优先级建议 #

优先尝试方案1，无需额外配置即可解决问题；如果必须使用源码版psycopg2，再考虑方案2（稳定性最佳）或方案3（快速临时解决）。

内容的提问来源于stack exchange，提问作者Divya Porwal Jain