Azure Pipeline部署.NET Framework 4.8 Azure Function异常排查

你的配置存在两处核心错误，这套参数是为.NET Framework MVC/IIS Web应用设计的，不适用于.NET Framework 4.8的Azure Function项目：

• VSBuild@1 任务中传入的 /p:WebPublishMethod=Package /p:PackageAsSingleFile=true 是Web项目IIS部署专属的打包规则，不会触发Azure Function项目的正确发布流程，无法生成和本地Visual Studio发布一致的publish目录结构。这也是为什么同样的配置部署MVC项目正常、部署Function异常的核心原因。
• ArchiveFiles@2 任务直接将源码路径 $(System.DefaultWorkingDirectory)/src/FunctionApp 作为打包根目录，这个路径指向仓库里的项目源码根目录，不是编译发布后的输出目录，打出来的压缩包自然只有项目根层级的源码文件，缺失bin目录、依赖程序集、各函数的function.json配置等运行必需内容。

1. 修改VSBuild任务的MSBuild参数，移除Web项目专属的打包配置，指定Function项目的正确发布输出路径，调整后参数如下：

   /p:DeployOnBuild=true /p:PublishUrl="$(build.artifactStagingDirectory)/FunctionApp/publish" /p:SkipInvalidConfigurations=true
   

   不需要保留WebPublishMethod、PackageAsSingleFile这类Web项目专属参数，MSBuild会自动识别Azure Function项目类型，按照和本地Visual Studio右键发布完全一致的逻辑，将所有部署必需文件输出到PublishUrl指定的路径下。你不需要在项目中提前创建FolderProfile发布配置文件，未指定具体配置文件时MSBuild会默认使用文件夹发布模式。
2. 调整ArchiveFiles任务的打包源路径，不要指向源码目录，改为指向MSBuild输出的publish目录：

   - task: ArchiveFiles@2
     displayName: 'Archive Function'
     inputs:
       rootFolderOrFile: '$(build.artifactStagingDirectory)/FunctionApp/publish'
       includeRootFolder: false
       archiveType: 'zip'
       archiveFile: '$(Build.ArtifactStagingDirectory)/FunctionApp.zip'
       replaceExistingArchive: true
   

3. 优化部署阶段的AzureFunctionApp任务参数，去掉容易匹配出错的通配符，直接指定压缩包路径即可：

   - task: AzureFunctionApp@1 
     inputs:
        azureSubscription: 'MyResourceGroup'
        appType: functionApp
        appName: 'MyFunction'
        package: '$(System.ArtifactsDirectory)/drop/FunctionApp.zip'
   

- task: VSBuild@1
  displayName: 'Build Solution'
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:PublishUrl="$(build.artifactStagingDirectory)/FunctionApp/publish" /p:SkipInvalidConfigurations=true'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: ArchiveFiles@2
  displayName: 'Archive Function'
  condition: and(succeeded(), eq(variables.isDeployableBranch, true))
  inputs:
    rootFolderOrFile: '$(build.artifactStagingDirectory)/FunctionApp/publish'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/FunctionApp.zip'
    replaceExistingArchive: true

验证方式：你可以在构建完成后下载drop工件里的FunctionApp.zip，解压后能看到bin目录、host.json、各函数对应的function.json文件，和本地Visual Studio发布生成的publish目录内容完全一致，即代表打包正确。

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