通过Azure DevOps Pipeline部署的Python函数应用无法识别函数且子文件夹未上传

看起来你遇到的核心问题是打包的目录结构不正确，导致Azure Functions无法找到你的函数代码，同时依赖安装的方式也需要调整适配Azure的运行环境。我帮你拆解下问题和具体解决方案：

一、核心问题：ArchiveFiles任务的目录配置错误 #

你当前的ArchiveFiles@2任务设置了includeRootFolder: true，这会把Function_App这个根文件夹整个打包进zip包。部署到Azure后，函数应用的工作目录下会多一层Function_App文件夹，而不是直接看到host.json、leanjira_timer_sync等内容——Azure Functions根本找不到正确的代码结构，自然识别不到函数。

而VS Code部署正常的原因是：VS Code的Azure Functions扩展会直接把Function_App目录下的所有内容同步到Azure，不会额外嵌套一层根文件夹，结构完全符合Azure的要求。

修正方案：调整ArchiveFiles的配置 #

把includeRootFolder改成false，这样打包的是Function_App内部的所有内容（包括子文件夹），而不是嵌套根目录：

- task: ArchiveFiles@2
  displayName: "Archive Function App Code"
  inputs:
    rootFolderOrFile: "$(System.DefaultWorkingDirectory)/JiraSync/Function_App"
    includeRootFolder: false # 关键：不包含Function_App根文件夹，直接打包内部内容
    archiveType: "zip"
    archiveFile: "$(Build.ArtifactStagingDirectory)/JiraSync/functionapp.zip"
    replaceExistingArchive: true

二、优化依赖安装方式（可选但推荐） #

你当前在Pipeline的虚拟环境里安装依赖，但没有把虚拟环境打包进zip——Azure Functions for Linux会使用自己的Python运行时，本地虚拟环境的依赖不会被识别。推荐两种适配方式：

方式1：让Azure自动安装依赖 #

给函数应用添加应用设置，让部署时自动拉取并安装requirements.txt的依赖，这种方式能避免本地和远程环境的依赖版本差异：

# 加在AzureFunctionApp任务之前
- task: AzureAppSettings@1
  displayName: "Enable Auto Dependency Installation"
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(functionAppName)
    appSettings: |
      [
        {
          "name": "SCM_DO_BUILD_DURING_DEPLOYMENT",
          "value": "true",
          "slotSetting": false
        }
      ]

方式2：手动安装依赖到函数目录 #

如果需要本地严格控制依赖版本，可以把依赖安装到函数目录的.python_packages文件夹（Azure Functions会自动识别这个目录）：

- script: |
    cd $(System.DefaultWorkingDirectory)/JiraSync/Function_App
    python -m pip install --upgrade pip
    pip install -r requirements.txt --target .python_packages/lib/site-packages
  displayName: "Install Dependencies to Function Directory"

之后打包时这个文件夹会被包含进去，Azure会直接使用这些预安装的依赖。

三、Python V2模型的额外配置（如果用装饰器模式） #

如果你使用Python V2编程模型（装饰器写法），需要确保host.json里有正确的扩展包配置，否则Azure可能无法识别函数：

{
  "version": "2.0",
  "logging": {
    "applicationInsights": {
      "samplingSettings": {
        "isEnabled": true,
        "excludedTypes": "Request"
      }
    }
  },
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  },
  "languageWorkers": {
    "python": {
      "defaultExecutablePath": "python3"
    }
  }
}

四、验证打包结构（可选但建议） #

修改完成后，建议在Pipeline里加一步查看zip内容的脚本，确认结构符合预期：

- script: |
    unzip -l $(Build.ArtifactStagingDirectory)/JiraSync/functionapp.zip
  displayName: "Verify Archive Structure"

正常的zip内容应该直接显示：

host.json
requirements.txt
leanjira_timer_sync/
leanjira_timer_sync/leansyncjira.py
leanjira_timer_sync/function.json
# （如果用方式2安装依赖，还会有.python_packages/目录）

这样调整后，部署到Azure的函数应用就能正确识别你的定时器函数了。

备注：内容来源于stack exchange，提问作者confusedJunior