通过Azure DevOps部署PowerShell Timer Trigger函数后无法识别的问题

核心原因分析 #

你遇到的问题主要来自两个常见场景：

• 目录结构不规范：Azure Functions Runtime要求每个函数必须放在wwwroot下的独立子目录中，直接将run.ps1和function.json放在根目录不会被识别为有效函数。
• 运行模式限制：如果Function App开启了「运行从包文件」模式，门户的「Develop in Portal」选项会被禁用，且新上传的文件需要重启App才能被加载。

分步解决方案 #

1. 检查并修正目录结构 #

确保你的文件路径符合以下规范：

wwwroot/
└── <你的函数名（比如TimerTrigger）>/
    ├── run.ps1
    └── function.json

如果之前直接上传到了wwwroot根目录，需要通过App Files页面将文件移动到新建的子目录中，或者重新部署时调整目录结构。

2. 检查运行模式并调整 #

1. 进入Function App的「配置」→「常规设置」页面
2. 查看「运行从包文件」选项：
   • 如果是开启状态：
     • 「Develop in Portal」会被禁用，这是预期行为（包运行模式下不支持在线编辑）
     • 上传文件后必须重启Function App，Runtime才会重新扫描并加载函数
   • 如果需要恢复门户开发功能，关闭该选项后保存并重启App

推荐的部署方式 #

针对PowerShell Function App，更规范的部署方式如下：

方式1：Azure DevOps Pipeline 官方任务

使用AzureFunctionApp@2任务部署，它会自动处理目录结构和包部署逻辑，示例配置：

- task: AzureFunctionApp@2
  inputs:
    azureSubscription: '你的Azure订阅名称'
    appType: 'functionApp'
    appName: '你的Function App名称'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    deploymentMethod: 'auto'

注意：打包时要确保zip包内的结构是wwwroot下的函数子目录，而非包含wwwroot本身。

方式2：手动打包部署

1. 将函数代码按规范目录结构整理（每个函数一个子目录）
2. 打包为zip文件（不要包含wwwroot文件夹，直接将子目录放在zip根目录）
3. 通过Azure CLI部署：

   az functionapp deployment source config-zip --resource-group <你的资源组名> --name <你的Function App名> --src <你的zip文件路径>
   

验证函数是否加载 #

• 查看「日志流」：重启App后，若看到Loading functions metadata及函数加载的日志，说明识别成功
• 使用Azure CLI查询：

  az functionapp function list --name <你的Function App名> --resource-group <你的资源组名>
  

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