Azure Functions运行时安装Python模块失败求助

问题概述 #

在Azure Functions中通过subprocess调用pip安装Python模块（如numpy），安装日志显示成功，但后续__import__操作始终提示No module named 'xxx'。本地运行相同代码无问题，已确认安装目录不在当前worker的sys.path中，且尝试Consumption、App Service两种托管选项均出现相同问题。

核心原因 #

1. worker进程隔离与路径不匹配：Azure Functions的Python worker默认使用/home/site/wwwroot/.python_packages/lib/site-packages作为第三方包目录，但动态pip install默认将模块安装到/home/.local/lib/python3.10/site-packages，该目录不在worker的sys.path列表中，导致解释器无法识别。
2. 进程生命周期限制：Consumption计划下worker会频繁回收重启，App Service计划实例重启后，动态安装的模块也会丢失，无法持久化生效。

解决方案 #

方案1：指定pip安装到函数默认包目录（临时动态安装场景） #

修改subprocess的pip命令，强制将模块安装到Azure Functions的官方包目录，同时显式确认路径加入sys.path：

import io
import json
import logging
import sys
import subprocess

import azure.functions as func

app = func.FunctionApp(http_auth_level=func.AuthLevel.ANONYMOUS)

@app.route(route="InstallModule")
def install_module(req: func.HttpRequest) -> func.HttpResponse:
    logging.info("install_module was triggered")
    data = req.get_json()
    module_name = data.get("module")

    output = None
    target_path = "/home/site/wwwroot/.python_packages/lib/site-packages"
    try:
        # 指定安装路径到函数官方包目录
        output = subprocess.run(f"pip install {module_name} --target {target_path}", 
                               shell=True, check=True, capture_output=True)
        logging.info(output)
        # 确保路径在sys.path中（即使已存在也显式添加避免缓存问题）
        if target_path not in sys.path:
            sys.path.append(target_path)
        __import__(module_name)
        output = f"{output.stdout.decode()}\n模块导入成功"
    except Exception as ex:
        logging.error(f"执行失败：{ex}")
        output = f"{output.stdout.decode() if output else ''}\n错误信息：{str(ex)}"

    return func.HttpResponse(str(output))

方案2：使用requirements.txt预安装（官方推荐） #

这是Azure Functions管理Python依赖的标准方式，彻底避免动态安装的各种问题：

1. 在项目根目录创建requirements.txt文件，添加需要的包及版本：

numpy==1.25.2

2. 部署项目时，Azure会自动将包安装到正确的目录，函数运行时可直接导入模块，无需动态安装操作。

方案3：临时添加用户安装目录到sys.path（不推荐） #

若必须使用用户目录安装，可在函数启动时将该目录加入sys.path：

import sys
# 在函数代码最顶部添加
sys.path.append("/home/.local/lib/python3.10/site-packages")

注意：该方式仅在当前worker进程生命周期内有效，进程重启后需重新安装模块，不适用于Consumption计划。

验证步骤 #

1. 修改代码后重新部署到Azure Functions
2. 发送POST请求测试模块安装与导入
3. 可在代码中添加以下打印语句，确认路径与安装状态：

# 打印当前sys.path
logging.info(f"当前sys.path: {sys.path}")
# 打印已安装的包
pip_freeze = subprocess.run("pip freeze", shell=True, capture_output=True).stdout.decode()
logging.info(f"已安装包列表:\n{pip_freeze}")

内容的提问来源于stack exchange，提问作者Ognjen B.