Azure Function App v2中python-pptx模块导入失败求助

以下是针对该问题的排查和解决步骤：

• 对齐Python版本环境
  Azure Functions运行时的Python版本必须和Github Actions中用于安装依赖的版本完全一致。在Github Actions的部署脚本（如.github/workflows/deploy.yml）中指定匹配的版本：

  steps:
    - uses: actions/setup-python@v4
      with:
        python-version: '3.10' # 替换为你Azure Function配置的Python版本
  

• 强制将依赖安装到指定目录
  Azure Functions默认从.python_packages/lib/site-packages加载第三方依赖，在Github Actions的安装步骤中明确指定目标路径：

  pip install -r requirements.txt --target .python_packages/lib/site-packages
  

• 验证部署包结构
  在Github Actions中添加步骤，检查依赖是否被正确安装到目标目录：

  ls -la .python_packages/lib/site-packages/pptx
  

  如果输出为空，说明依赖未被正确打包进部署包，需要检查安装命令是否执行成功。

• 清理Azure侧缓存
  旧部署缓存可能导致依赖加载异常，通过Azure CLI部署时添加--clean参数清理旧文件：

  az functionapp deployment source config-zip -g <你的资源组名> -n <函数应用名> --src <部署压缩包路径> --clean
  

  也可以直接在Azure Portal中重启函数应用，强制加载新的依赖文件。

• 排查导入逻辑问题
  将pptx的导入移至函数文件顶部，提前触发依赖检查，排除延迟导入导致的路径问题：

  import azure.functions as func
  import logging
  import pptx # 提前导入，验证环境是否能找到模块
  
  logging.basicConfig(level=logging.INFO)
  app = func.FunctionApp()
  
  @app.route(route="http_trigger", methods=["get", "post"])
  def http_trigger(req: func.HttpRequest) -> func.HttpResponse:
      from assets.powerpoint import PPTManager
      logging.info('Python HTTP trigger function processed a request.')
      return func.HttpResponse("Hello World", status_code=200)
  

• 锁定依赖版本
  尝试指定python-pptx的稳定版本，避免依赖冲突：

  # requirements.txt中修改为
  python-pptx==0.6.21
  

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