Azure DevOps中多项目Web与Function App部署故障排查

核心问题定位方向 #

针对你的场景（Web App+Isolated Worker Function同仓库、调整流水线后Web部署失败），常见故障点集中在打包/发布路径混淆、项目构建配置错误、部署参数不匹配这三类：

分步排查与修复 #

1. 修正打包阶段的项目指向与输出隔离 #

最初出现Function部署Web包的问题，说明打包阶段未明确区分两个项目。调整后需确保Web和Function的打包任务各自指向对应项目，且输出路径完全分离：

# Web App 打包任务（明确指定Web项目文件）
- task: DotNetCoreCLI@2
  displayName: 'Build & Publish Web App'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/[你的Web项目名称].csproj'
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)/web'
    zipAfterPublish: true

# Isolated Worker Function 打包任务（明确指定Function项目文件）
- task: DotNetCoreCLI@2
  displayName: 'Build & Publish Function App'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/[你的Function项目名称].csproj'
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)/func'
    zipAfterPublish: true

2. 确保Web App部署任务指向正确的包 #

检查部署阶段的package参数，必须指向Web App的打包产物，而非Function的：

# Web App 部署到对应槽位
- task: AzureWebApp@1
  displayName: 'Deploy Web App to $(WebAppSlot)'
  inputs:
    azureSubscription: '$(AzureServiceConnection)'
    appType: 'webApp'
    appName: '$(WebAppName)'
    deployToSlotOrASE: true
    resourceGroupName: '$(ResourceGroup)'
    slotName: '$(WebAppSlot)'
    package: '$(Build.ArtifactStagingDirectory)/web/*.zip' # 重点：指向web目录下的包
    deploymentMethod: 'zipDeploy'

3. 验证共享库的构建依赖 #

Web App依赖共享库，需确保共享库在Web打包前已完成构建，避免缺失依赖导致部署失败：

# 先构建共享库
- task: DotNetCoreCLI@2
  displayName: 'Build Shared Library'
  inputs:
    command: 'build'
    projects: '**/[你的共享库项目名称].csproj'
    arguments: '--configuration $(BuildConfiguration)'

4. 检查Azure Web App运行时配置 #

登录Azure门户，确认Web App的配置 > 常规设置中：

• 运行时堆栈选择.NET 9 (STS)
• 架构（x64/x86）与流水线构建时的目标架构一致

5. 新增日志排查步骤（快速定位问题） #

若以上调整后仍失败，在流水线中添加文件列表命令，确认打包产物是否生成正确：

- script: 'tree /F $(Build.ArtifactStagingDirectory)'
  displayName: 'List All Artifact Files'

关键注意事项 #

• Isolated Worker模式的Function不能使用publishWebProjects: true，必须指定具体项目文件，否则会误打包Web项目
• Web App的4个部署槽需确保每个槽的部署任务使用对应的slotName变量，避免串槽
• 确认流水线服务连接对Web App及对应槽位有Contributor权限，避免部署时权限不足

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