Azure DevOps部署.NET 8 Web应用至App Service遇500错误求助

问题描述 #

尝试通过Azure DevOps CI/CD管道部署.NET 8 Web应用到Azure，重新配置App Service与管道后仍出现部署失败，错误信息如下：

##[error]Failed to deploy web package to App Service.
##[warning]Can't find loc string for key: KuduStackTraceURL
##[error]KuduStackTraceURL https://$:***@.scm.azurewebsites.net/api/vfs/LogFiles/kudu/trace
##[error]Error: Error: Failed to deploy web package to App Service. Internal Server Error (CODE: 500)

已尝试的操作：

• 在App Service环境变量中添加WEBSITE_WEBDEPLOY_USE_SCM
• 通过Kudu删除Deployments文件夹

应用依赖Azure SQL DB、Key Vault和Blob Storage，暂认为这些服务不影响部署流程，但对此领域经验有限。

当前管道YAML #

trigger:
- development

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: VSTest@2
  inputs:
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true

# - task: PublishBuildArtifacts@1
#   inputs:
#     PathtoPublish: '$(Build.ArtifactStagingDirectory)'
#     ArtifactName: 'drop'
#     publishLocation: 'Container'

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<My service Connection>'
    appType: 'webApp'
    appName: '<App-Name>'
    deployToSlotOrASE: true
    resourceGroupName: '<ResourceGroup>'
    slotName: 'production'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    appSettings: '-WEBSITE_RUN_FROM_PACKAGE 1'
    deploymentMethod: 'auto'

旧版管道参考 #

trigger:
- development

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: VSTest@2
  inputs:
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration)'
    zipAfterPublish: true
    
- task: AzureWebApp@1
  inputs:
    azureSubscription: '<My Subscription>'
    appType: 'webApp'
    appName: '<My Resource>'
    package: '$(System.DefaultWorkingDirectory)/**/*.zip'
    appSettings: '-WEBSITE_RUN_FROM_PACKAGE 1'
    deploymentMethod: 'auto'

排查与修复建议 #

1. 移除重复打包步骤 #

当前管道同时使用VSBuild@1（带DeployOnBuild=true参数）和DotNetCoreCLI@2 publish，会生成两个冲突的部署包，导致部署异常。推荐保留DotNetCoreCLI@2 publish（更适配.NET 8项目），调整后的步骤示例：

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSTest@2
  inputs:
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

- task: DotNetCoreCLI@2
  inputs:
    command: 'publish'
    publishWebProjects: true
    arguments: '--configuration $(buildConfiguration) --output $(build.artifactStagingDirectory)'
    zipAfterPublish: true

- task: AzureWebApp@1
  inputs:
    azureSubscription: '<My service Connection>'
    appType: 'webApp'
    appName: '<App-Name>'
    deployToSlotOrASE: true
    resourceGroupName: '<ResourceGroup>'
    slotName: 'production'
    package: '$(build.artifactStagingDirectory)/**/*.zip'
    appSettings: '-WEBSITE_RUN_FROM_PACKAGE 1'
    deploymentMethod: 'auto'

2. 明确部署包路径 #

将AzureWebApp@1的package参数改为$(build.artifactStagingDirectory)/**/*.zip，避免匹配到多余的zip包（比如旧步骤生成的冗余文件）。

3. 调整WEBSITE_RUN_FROM_PACKAGE配置 #

WEBSITE_RUN_FROM_PACKAGE=1会将部署包挂载为只读文件系统，可能引发Kudu部署权限问题：

• 暂时移除该配置，用常规部署方式验证是否能成功
• 若需保留，确保部署包结构正确，且App Service存储配置无异常

4. 检查服务连接权限 #

确认Azure DevOps中的服务连接拥有目标App Service和资源组的Contributor权限，权限不足会导致部署时的内部错误。

5. 查看Kudu详细日志 #

访问错误信息中的Kudu trace URL，查看具体的部署失败堆栈，里面会包含文件锁定、权限冲突或配置错误等细节。

6. 验证App Service运行时配置 #

确保App Service的运行时设置为.NET 8，且操作系统（Windows/Linux）与项目编译目标一致。

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