Azure Function App V2迁移后函数未显示问题求助

核心问题定位与修复步骤 #

1. 修正部署文件结构 #

Azure Functions Python V2（工作者模型）要求function_app.py必须放置在项目根目录，而非子文件夹中。当前你的function_app.py位于monitoring_weekly子文件夹，平台无法扫描识别。

• 解决方案：将function_app.py及所有依赖的python_file1.py~python_file5.py移动到项目根目录，调整后结构应为：

  - function_app.py
  - python_file1.py
  - python_file2.py
  - python_file3.py
  - python_file4.py
  - python_file5.py
  - host.json
  - local.settings.json
  

2. 修复host.json配置错误 #

你的host.json中scheduleStatusFilePath配置错误，该字段用于指定定时器状态存储路径，不应设置为app_offline.htm（此文件用于让应用离线），会干扰触发器正常加载：

• 修正后的host.json：

  {
      "version": "2.0",
      "extensionBundle": {
        "id": "Microsoft.Azure.Functions.ExtensionBundle",
        "version": "[4.0.0, 5.0.0)"
      },
      "extensions": {
        "timer": {
          "maxConcurrentExecutions": 1
        }
      }
    }
  

  移除错误的scheduleStatusFilePath配置，使用默认状态存储路径即可。

3. 调整function_app.py代码逻辑 #

当前你在模块级别直接执行batch_execution(file_list)，这会在函数初始化阶段运行，而非定时器触发时执行，可能引发初始化异常导致函数无法注册：

• 将批量执行逻辑移至main函数内部，修正后代码片段：

  def main(mytimer: func.TimerRequest) -> None:
      utc_timestamp = datetime.datetime.utcnow().replace(
          tzinfo=datetime.timezone.utc).isoformat()
      
      if mytimer.past_due:
          logging.info('The timer is past due!')
          
      logging.info('Python timer trigger function ran at %s', utc_timestamp)
      
      # 将批量执行逻辑移至触发器函数内
      exceptions = batch_execution(file_list)
      if exceptions:
          logging.error(f"脚本执行出现错误: {exceptions}")
      else:
          logging.info("所有脚本执行成功")
  
  # 移除模块级别的直接调用
  # batch_execution(file_list)
  

4. 排查部署与运行日志 #

• 登录Azure门户，进入目标Function App，查看部署中心的部署日志，确认是否存在文件复制、权限类错误。
• 打开日志流（Log Stream），查看函数启动阶段的报错信息，比如模块导入失败、文件路径错误等，这些都会导致函数无法被平台识别。

5. 确认运行时配置 #

• 确认Function App的运行时栈为Python 3.10，运行时版本4.x（V2模型要求）。
• 检查应用设置中的FUNCTIONS_WORKER_RUNTIME是否设置为python，该配置是Python函数运行的必要条件。

内容的提问来源于stack exchange，提问作者Mitchell.Laferla