VS Code部署Azure Functions（Python3.9+扩展~4）失败求助

可能原因 #

• 本地与远程环境不同步：Python 3.9 和 Functions Runtime ~4 的依赖体系与旧版本差异明显，若本地VS Code仍使用Python 3.7环境打包，会导致依赖与远程环境不兼容。
• 远程构建依赖不兼容：Runtime ~4 对Python 3.9的依赖包有特定版本要求，比如azure-functions包需匹配Runtime版本，或requirements.txt中存在Python 3.9不支持的老旧包。
• 部署配置未适配新版本：VS Code的部署设置可能沿用旧版本规则，未针对Runtime ~4调整远程构建参数。
• Azure门户配置遗漏：切换Python版本和Runtime后，未正确设置PYTHON_VERSION、FUNCTIONS_WORKER_RUNTIME等核心环境变量。

解决方法 #

• 同步本地Python环境：在VS Code中切换Python解释器为3.9版本，基于3.9创建新虚拟环境，重新执行pip install -r requirements.txt安装依赖。
• 更新本地工具链：将azure-functions-core-tools升级至v4.x版本，命令：npm install -g azure-functions-core-tools@4 --unsafe-perm true。
• 检查依赖清单：清理requirements.txt中Python 3.9不兼容的包，确保azure-functions版本≥1.10.0（适配Runtime ~4）。
• 调整VS Code部署配置：在.vscode/settings.json中确认azureFunctions.deploySubpath指向正确的函数项目根目录，azureFunctions.scmDoBuildDuringDeployment设为true。
• 验证Azure门户配置：进入函数应用的「配置」页面，确认：
  • FUNCTIONS_EXTENSION_VERSION设为~4
  • PYTHON_VERSION设为3.9
  • FUNCTIONS_WORKER_RUNTIME设为python
  • 应用服务计划支持Python 3.9（Windows计划需确认版本兼容性，Linux计划无特殊限制）
• 手动排查远程构建日志：通过Kudu工具查看详细报错：
  1. 进入函数应用的「开发工具」>「高级工具」，点击「Go」
  2. 打开「Debug console」>「CMD」，上传项目zip包至site/wwwroot
  3. 执行python -m pip install -r requirements.txt，根据终端输出定位具体依赖问题
• 清理部署缓存：在Kudu的「Debug console」中删除site/wwwroot下的旧文件，或在VS Code部署时勾选「清除目标文件夹」选项。

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