部署Azure Function时遭遇构建失败问题求助

核心排查步骤 #

• 对齐Python版本：本地开发使用的Python版本必须和Azure Function App配置的FUNCTIONS_WORKER_RUNTIME_VERSION完全一致，比如本地用3.9，云端也要设为3.9，版本不匹配会导致依赖安装失败。
• 补全依赖清单：即使本地pip install requirements.txt成功，也可能存在隐式依赖未写入文件。执行pip freeze > requirements.txt重新生成完整依赖，或者用pipreqs . --force生成精准的生产环境依赖（排除pytest等测试包）。
• 查看详细构建日志：从截图无法定位具体错误，需在VS Code的Azure扩展中找到对应Function App，打开「日志」面板查看构建日志的完整报错信息，常见问题包括依赖版本冲突、Linux环境缺少系统级依赖（如libssl-dev）。
• 本地模拟云端构建：用Azure Functions Core Tools执行func azure functionapp publish <你的应用名> --build-local，在本地模拟Azure的构建流程，更容易发现本地环境和云端的差异。执行前确保Core Tools是最新版：npm install -g azure-functions-core-tools@4 --unsafe-perm true。
• 检查云端配置：确认Azure Function App的WEBSITE_RUN_FROM_PACKAGE设置，开启该选项会直接使用本地构建的包，跳过云端构建环节，可规避部分云端环境的构建问题。

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