通过VS Code部署Python Azure Function V2：函数列表未显示

架构老林

2026-8-9

问题

基于Python V2编程模型的HttpTrigger函数在本地Azure Function运行时可正常工作，但部署到Azure函数应用后出现以下问题：

函数列表中看不到已注册的函数
对应的托管URL路由调用无效
函数应用根URL可正常返回主页，说明托管运行时状态正常
部署过程无报错，显示成功

环境信息：Mac OSX系统的VS Code，Python版本3.9；此前成功部署过TypeScript函数，不愿回退到V1模型，偏好VS Code直接部署方式。

函数代码示例：

import azure.functions as func
import logging

app = func.FunctionApp()

@app.function_name(name="HttpTrigger1")
@app.route(route="hello")
def test_function(req: func.HttpRequest) -> func.HttpResponse:
     logging.info('Python HTTP trigger function processed a request.')

     name = req.params.get('name')
     if not name:
        try:
            req_body = req.get_json()
        except ValueError:
            pass
        else:
            name = req_body.get('name')

     if name:
        return func.HttpResponse(f"Hello, {name}. This HTTP triggered function executed successfully.")
     else:
        return func.HttpResponse(
             "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.",
             status_code=200
        )

解决方法

核对函数应用Python版本
在Azure门户进入函数应用的配置->常规设置，确认Python版本设置为3.9，与本地开发版本一致，版本不匹配会导致函数无法加载。
验证host.json与运行时配置
确保部署的host.json包含正确的扩展包配置，Python V2模型依赖该配置加载扩展：
```
{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}
```
同时检查Azure应用设置中的FUNCTIONS_WORKER_RUNTIME值为python，该配置需与本地local.settings.json保持一致。
检查部署文件完整性
通过Azure门户的高级工具(Kudu)->调试控制台->CMD，查看site/wwwroot目录：
- 确认存在function_app.py主文件
- 确认requirements.txt包含azure-functions>=1.14.0（Python V2的最低依赖版本）
- 确认.python_packages目录存在且已安装所有依赖
查看运行时日志排查错误
在Azure门户进入函数应用的监控->日志，查看运行时输出，通常能找到函数加载失败的具体原因，比如依赖缺失、语法兼容问题等。
清理后重新部署
在VS Code的Azure扩展中部署时，勾选部署前删除目标文件夹中的所有文件，避免旧版本文件或残留配置干扰。
确认函数应用运行时版本
在Azure门户配置->常规设置中，确保运行时版本设置为~4，Python V2模型仅支持4.x及以上运行时版本。

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