基于Python的Azure Functions编程模型V2（GitHub Actions部署）未出现在函数列表

• 确认编程模型配置与依赖
  确保项目已正确适配V2编程模型：

  • 引用对应语言的V2模型依赖包（如.NET需Microsoft.Azure.Functions.Worker及扩展包，Python需azure-functions 1.x以上版本并启用V2模式）。
  • 检查host.json中指定了兼容的扩展包版本，示例：

    {
      "version": "2.0",
      "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.*, 5.0.0)"
      }
    }
    

  • 函数代码使用V2模型的特性标注，比如存储队列触发器需使用对应命名空间下的QueueTrigger特性。

• 验证部署文件完整性
  尽管GitHub Actions工作流显示成功，仍需确认部署内容正确：

  • 查看GitHub Actions部署步骤的日志，确认编译后的所有产物（如bin目录、自动生成的function.json）都已上传至Azure。
  • 通过Azure函数应用的Kudu工具（高级工具>CMD），检查site/wwwroot目录下的文件是否与本地编译结果一致，重点确认函数元数据文件是否存在。

• 检查函数应用运行时配置

  • 在Azure门户的函数应用配置>常规设置中，确认运行时版本与项目匹配（如.NET Isolated需对应.NET版本，Python V2需3.10+版本）。
  • 确保FUNCTIONS_WORKER_RUNTIME设置正确：.NET Isolated填dotnet-isolated，Python V2填python并开启FUNCTIONS_V2_COMPATIBILITY_MODE为true。

• 排查存储队列触发器配置

  • 确认函数应用的应用设置中已添加正确的存储连接字符串（如AzureWebJobsStorage），且该连接拥有目标队列的读写权限。
  • 检查触发器代码中的队列名称、连接字符串名称是否拼写正确，示例：

    [Function("QueueProcessor")]
    public void ProcessQueue([QueueTrigger("order-queue", Connection = "AzureWebJobsStorage")] string queueItem)
    {
        // 业务逻辑
    }
    

• 查看函数应用日志排查错误
  进入Azure门户的函数应用监控>日志，筛选函数启动阶段的日志，查看是否存在依赖缺失、配置错误等导致函数无法加载的报错信息。

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