Azure Functions放入文件夹后无法被识别的问题求助

1. 修正函数文件夹结构与文件规范 #

Azure Functions Python V1要求每个函数必须是独立的子文件夹，且每个函数目录下必须包含两个核心文件：

• __init__.py：包含函数触发逻辑（必须带对应触发装饰器，比如@blob_trigger、@http_trigger，并定义main入口函数）
• function.json：函数配置文件（定义触发源、输入输出绑定，V1版本必须存在，不能省略）

你的当前结构存在的问题：

• chat、ask、translate目录下的__init__应为__init__.py（文件名拼写错误），且均缺少function.json
• translate/functions下的getBlob等子目录，未明确包含__init__.py和function.json，不符合V1函数识别规范

标准V1 Python函数结构参考：

- 根目录/
  - host.json
  - local.settings.json
  - requirements.txt
  - chat/
    - __init__.py
    - function.json
  - ask/
    - __init__.py
    - function.json
  - translate/
    - __init__.py
    - function.json
    - getBlob/  # 若为独立函数，需遵循标准结构
      - __init__.py
      - function.json

2. 修复host.json版本冲突 #

你明确使用V1版本函数，但当前所有host.json均配置了"version": "2.0"（这是Functions Runtime V2的配置），且包含V1不支持的extensionBundle节点，直接导致运行时识别失败。

V1版本的host.json正确配置：

{
  "version": "1.0",
  "logging": {
    "fileLoggingMode": "debugOnly",
    "logLevel": {
      "default": "Information"
    }
  }
}

同时需确保本地运行的Functions Runtime为V1版本，可通过func --version检查，若为V2+需切换对应环境。

3. 解决Python版本与Runtime的兼容问题 #

Azure Functions V1仅支持Python 3.6~3.8，Python 3.10属于高版本，与V1 Runtime完全不兼容，这是导致函数无法识别的核心原因之一。

两种解决方案：

• 降级Python环境至3.8及以下，匹配V1 Runtime要求
• 将函数升级至V4版本（适配Python 3.10），同步更新host.json为V4配置，使用新的装饰器范式（需安装azure-functions>=1.17.0）

4. 本地调试的快速排查步骤 #

• 激活对应Python虚拟环境，执行pip install -r requirements.txt确保依赖安装完整
• 检查每个函数的__init__.py，确认触发装饰器（V1为@azure.functions.annotation.*_trigger）和main函数定义正确
• 运行func start --verbose查看详细日志，定位未识别函数的具体报错
• 执行func azure functionapp publish <你的函数应用名> --dry-run，查看流水线预校验的函数列表，排查结构或配置问题

5. 流水线识别的额外配置检查 #

若使用Azure DevOps/GitHub Actions流水线，需确认：

• 流水线任务中设置了正确的Runtime版本：AZURE_FUNCTIONS_RUNTIME_VERSION=1（针对V1）
• 打包路径指向项目根目录，而非子文件夹
• 无自定义配置文件（如func.yaml）限制函数识别路径

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