Azure Python函数V2部署成功后不显示问题求助

核心原因 #

Python V2编程模型靠代码注解定义函数，根本不需要手动写function.json——但部署时如果配置不对，Azure识别不了你的函数定义，自然门户里就看不到。

排查修复步骤 #

1. 先把本地项目的基础配置捋顺 #

• 检查function_app.py的注解格式是否符合V2要求：

  import azure.functions as func
  import logging
  
  app = func.FunctionApp()
  
  @app.timer_trigger(schedule="0 */5 * * * *", arg_name="myTimer", run_on_startup=False,
              use_monitor=False)
  def timer_trigger(myTimer: func.TimerRequest) -> None:
      if myTimer.past_due:
          logging.info('The timer is past due!')
  
      logging.info('Python timer trigger function executed.')
  

  必须有func.FunctionApp()实例，@app.timer_trigger的参数不能缺。

• 确认requirements.txt里的依赖版本够：

  azure-functions>=1.17.0
  

  版本太低的话，V2模型的注解可能不被支持。

• 检查local.settings.json里的运行时配置：

  {
    "IsEncrypted": false,
    "Values": {
      "FUNCTIONS_WORKER_RUNTIME": "python",
      "AzureWebJobsStorage": "UseDevelopmentStorage=true"
    }
  }
  

  FUNCTIONS_WORKER_RUNTIME必须是python，不然runtime不认。

2. 本地先跑通再部署 #

用Azure Core Tools启动本地函数，确认能正常触发：

func start

如果本地能跑，说明代码没问题，问题出在部署环节。

3. 调整VS Code的部署设置 #

• 部署时选对Function App：确认目标App的运行时是Python 3.11，计划是消费型。
• 部署时勾选「Deploy with Zip Deploy」：增量部署容易丢文件，用Zip包部署更稳。
• 检查.vscode/settings.json的配置：

  {
    "azureFunctions.deploySubpath": ".",
    "azureFunctions.pythonV2Model": true,
    "azureFunctions.projectLanguage": "Python",
    "azureFunctions.projectRuntime": "~4"
  }
  

  一定要把azureFunctions.pythonV2Model设为true，强制按V2模型部署。

4. 检查Azure门户的App配置 #

进Function App的「Configuration」→「Application settings」，确认这几个参数：

• FUNCTIONS_EXTENSION_VERSION：设为~4（V2模型必须用v4 runtime）
• FUNCTIONS_WORKER_RUNTIME：python
• PYTHON_VERSION：3.11（和本地的3.11.8一致）

5. 用Azure CLI手动部署试试 #

有时候VS Code的扩展可能抽风，用CLI打包部署更可靠：

az functionapp deployment source config-zip -g <你的资源组名> -n <你的函数App名> --src <本地项目打包的zip路径>

打包的时候要把所有项目文件都包含进去，别漏了function_app.py和requirements.txt。

6. 查日志找问题 #

• 在VS Code的Azure扩展里看「Deployment Center」的日志，确认部署过程有没有报错。
• 去Azure门户的「Monitor」→「Logs」里看运行日志，有没有函数初始化失败的信息，比如依赖装不上、注解格式错了之类的。

重点提醒 #

Python V2模型本来就不需要手动创建function.json，部署后是Azure runtime自动生成的——如果门户看不到函数，大概率是runtime没识别到你的注解，要么是代码格式错了，要么是配置不对，要么是版本不兼容。

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