Azure Function部署后Python函数目录缺失问题排查求助

目录缺失&函数未加载的核心原因 #

• ZIP打包路径错误：如果打包时未从项目根目录执行命令，会导致子目录未被正确纳入包中。比如在项目根目录的上级目录执行zip -r func.zip my-project/，会让zip包内多一层嵌套目录，部署后Azure解压的根目录里并不会直接出现blob-trigger，自然门户看不到，函数也加载失败。
• 部署命令参数问题：使用az functionapp deployment source config-zip时，若指定的zip路径错误、遗漏--resource-group或--name等关键参数，可能导致部署不完整，部分目录未上传。
• Python v2模型的结构要求：v2模型虽不需要function.json，但要求函数目录必须直接放在项目根目录下，且__init__.py中必须有正确的函数装饰器（如@app.blob_trigger(...)）。若目录嵌套错误或装饰器配置缺失/错误，即使目录存在，函数也不会被注册加载，门户可能因无有效函数而不显示对应目录。
• 部署同步延迟：免费订阅的Consumption计划偶尔会出现部署同步延迟，导致目录未及时显示，但这种情况通常会在数分钟内恢复。

进一步调试步骤 #

• 验证本地ZIP包内容：解压本地的部署zip包，确认blob-trigger目录及其中的__init__.py存在。若缺失，重新从项目根目录执行打包命令：zip -r func.zip .（末尾的.表示打包当前目录下所有内容）。
• 检查部署命令输出：重新执行部署命令，确保无警告或错误。示例命令：

  az functionapp deployment source config-zip --resource-group <你的资源组名> --name <你的函数应用名> --src func.zip
  

  确认返回“部署成功”的提示。
• 远程查看服务器文件系统：用Azure CLI直接查看函数应用的远程目录结构：

  az functionapp exec --resource-group <资源组名> --name <函数应用名> --command "ls -l"
  

  若能看到blob-trigger目录，说明是门户显示延迟；若看不到，证明部署时目录未上传。
• 检查函数代码的正确性：确认__init__.py符合v2模型规范，示例正确代码：

  import azure.functions as func
  app = func.FunctionApp()
  
  @app.blob_trigger(arg_name="myblob", path="目标容器名/{name}", connection="AzureWebJobsStorage")
  def blob_trigger(myblob: func.InputStream):
      print(f"处理Blob：{myblob.name}，大小：{myblob.length}字节")
  

  确保connection参数对应的应用设置存在且有效。
• 查看函数加载日志：在门户的日志流中搜索FunctionRuntime关键词，查看是否有函数加载失败的具体错误（如装饰器缺失、配置不匹配等）。
• 检查部署中心日志：进入函数应用的部署中心，查看部署历史记录，确认是否有解压失败、文件上传不全的日志信息。

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