Sentence-transformers模块导致Azure Function App部署失败求助

问题背景 #

部署Python代码到Azure Functions Flex Consumption（基础层）时出现超时，报错：

部署ID无法找到，请重试。

环境信息：

• Python版本：3.11
• 本地环境：macOS Sequoia 15.2
• 目标环境：Linux
• 部署方式：Azure CLI，执行命令：

func azure functionapp publish <APP_NAME> --verbose --debug

怀疑是sentence-transformers模块导致部署失败，以下是针对性解决方案：

解决方案 #

1. 预打包模型文件，避免部署时在线下载 #

sentence-transformers默认会在首次运行时下载大体积预训练模型，这是部署超时的常见诱因：

• 本地运行一次函数代码，让模块自动下载模型到本地缓存目录（通常为~/.cache/huggingface/hub）；
• 将下载完成的模型文件夹复制到函数项目根目录下的models子目录；
• 修改代码中的模型加载路径，指定本地路径：

  # 原代码
  # model = SentenceTransformer('all-MiniLM-L6-v2')
  # 修改后
  model = SentenceTransformer('./models/all-MiniLM-L6-v2')
  

• 检查.funcignore文件，确保models目录未被排除在部署包外。

2. 调整部署超时配置 #

Flex Consumption计划的默认部署超时可能不足以完成大依赖安装，可通过Azure CLI调整：

az functionapp config appsettings set --name <APP_NAME> --resource-group <你的资源组名> --settings WEBSITE_DEPLOYMENT_IDLE_TIMEOUT=300

（300为超时秒数，可根据实际情况调整至600秒以内）

3. 使用远程构建部署 #

本地macOS环境与Azure Linux环境的依赖编译可能存在差异，改用远程构建让Azure在目标环境中安装依赖：

func azure functionapp publish <APP_NAME> --build remote --verbose

4. 优化依赖清单 #

• 在requirements.txt中指定sentence-transformers的具体稳定版本，例如：

  sentence-transformers==2.2.2
  

• 删除清单中未使用的依赖，减少安装耗时。

排查验证 #

查看详细部署日志确认问题根源：

az functionapp log deployment list --name <APP_NAME> --resource-group <你的资源组名>

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