VSCode无法将Python Azure Function部署至Azure函数应用

1. 检查文件结构与核心配置 #

• 确认本地项目里每个函数都有独立子文件夹，且包含function.json（比如HttpTrigger/function.json），Azure完全依赖这个文件识别函数，路径错误或文件缺失直接导致不显示。
• 打开requirements.txt核对所有依赖，部署时依赖安装失败会让函数无法加载。可以通过Portal进入函数应用的「高级工具」打开Kudu控制台，查看LogFiles/kudu/trace下的部署日志，确认依赖是否安装完成。
• 检查local.settings.json里的FUNCTIONS_WORKER_RUNTIME是否为python，部署时该配置会同步到应用设置，值不对的话运行时不会识别Python函数。

2. 查看运行时日志与Portal缓存 #

• 在Portal的函数应用里进入「监测」->「日志」，开启实时日志，排查是否有函数加载失败的错误（比如模块缺失、代码语法错误）。
• 点击「函数」页面右上角的刷新按钮，Portal偶尔会因为缓存延迟显示函数。

3. 验证部署目标与方式 #

• 确认部署时选中的函数应用是目标资源，避免误部署到其他订阅或资源组的应用里。
• 如果用VS Code部署，查看输出面板的部署日志，排查是否有文件上传不全、权限警告等问题。
• 尝试用Azure CLI重新部署，远程构建能避免本地与Azure环境差异：

  func azure functionapp publish <你的函数应用名称> --build remote
  

4. 检查函数应用状态与包运行配置 #

• 确认函数应用处于「运行中」状态，停止状态下函数不会被加载显示。
• 查看应用设置里的WEBSITE_RUN_FROM_PACKAGE，如果设为1（从包运行），要确保包文件完整上传。可以在Kudu控制台的site/wwwroot目录下检查是否存在对应函数的文件夹和文件。

5. 核对Python版本兼容性 #

• 确保本地使用的Python版本和Azure函数应用配置的版本一致（在Portal的「配置」->「常规设置」里查看），版本不兼容会导致函数无法加载。

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