Python3.10版Azure Functions v2部署成功却无可用函数，求排查日志方法

1. 从Azure Portal查看实时与历史日志 #

• 进入目标Function App，左侧导航选择监控 > 日志，启用Log Analytics（未配置时按引导完成）。
• 执行以下查询获取关键日志：
  • 查看部署与控制台输出：

    AppServiceConsoleLogs
    | where TimeGenerated > ago(1h)
    | sort by TimeGenerated desc
    

  • 查看函数运行时日志：

    FunctionAppLogs
    | where TimeGenerated > ago(1h)
    | sort by TimeGenerated desc
    

• 若需长期留存日志，可在诊断设置中配置将日志导出至存储账户、事件中心或Log Analytics。

2. 重新部署时获取详细部署日志 #

• 执行部署命令时添加--verbose参数，捕获完整部署流程输出：

  func azure functionapp publish <你的FunctionApp名称> --verbose
  

• 重点关注依赖安装、函数注册阶段的输出，排查是否存在文件缺失、权限错误或依赖加载失败的提示。

3. 通过Kudu工具检查文件与底层日志 #

• 在Function App的**开发工具 > 高级工具（Kudu）**中进入控制台：
  • 导航到site/wwwroot，确认函数文件夹（每个函数对应独立子目录）、host.json、requirements.txt等核心文件是否完整上传。
  • 查看LogFiles/Application/functions目录下的运行时日志，以及LogFiles/DeploymentTools中的部署日志，定位函数加载失败的具体原因。

4. 开启运行时Debug级日志 #

• 在Function App的配置 > 应用程序设置中添加/修改以下配置：
  • AzureFunctionsJobHost__logging__logLevel__Default = Debug
  • AzureFunctionsJobHost__logging__console__isEnabled = true
• 保存配置后重启Function App，再通过Portal日志或Kudu查看更详细的函数初始化、加载日志。

5. 本地模拟云端环境验证 #

• 同步云端应用设置到本地：

  func azure functionapp fetch-app-settings <你的FunctionApp名称>
  

• 运行func host start启动本地函数主机，查看控制台输出是否有异常，对比本地与云端的运行差异。

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