.NET Framework 4.6.1 Web API Azure DevOps CICD部署后站点无更新问题咨询

核心问题排查方向 #

90%以上的该类问题都是构建归档产物的目录结构错误导致：

• 你当前构建步骤输出的站点内容（web.config、bin文件夹、Swagger相关静态文件等）都在$(System.DefaultWorkingDirectory)\WebAppContent路径下
• 如果归档任务默认勾选了「将根文件夹名称添加到存档路径」，最终生成的ZIP包解压后第一层是WebAppContent文件夹，而非直接的站点文件
• 部署时该ZIP会被整体解压到Azure App Service的默认站点根目录site/wwwroot下，导致IIS无法在根目录找到web.config等启动文件，出现404页面不存在错误

具体修复步骤 #

1. 修正构建流水线归档任务配置 #

• 经典界面操作：找到「归档文件」任务，取消勾选将根文件夹名称添加到存档路径选项
• YAML配置操作：将归档任务的prefixRootFolder属性设置为false，示例：

- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(System.DefaultWorkingDirectory)\WebAppContent'
    includeRootFolder: false # 核心配置，取消根目录嵌套
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'
    replaceExistingArchive: true

• 验证方式：手动下载构建流水线生成的ZIP包，解压后第一层直接可见web.config、bin文件夹即为正确，若存在外层WebAppContent文件夹则说明配置未生效

2. 补充MSBuild必要参数 #

在原有构建参数基础上添加Release配置指定，避免Debug配置构建产生异常：
/p:Configuration=Release /p:DeployOnBuild=true /p:DeployDefaultTarget=WebPublish /p:WebPublishMethod=FileSystem /p:DeleteExistingFiles=True /p:publishUrl="$(System.DefaultWorkingDirectory)\WebAppContent"
如果解决方案包含多个项目，可额外添加/p:Project=<你的WebAPI项目名称.csproj>指定构建目标。

3. 优化发布流水线配置 #

• 确认Azure Web App Deploy任务的「部署到虚拟应用程序」选项为空，避免部署到非根目录的虚拟路径
• 可将包路径从模糊匹配$(System.DefaultWorkingDirectory)/**/*.zip改为精确匹配构建产物路径，例如构建产物名为drop时使用$(System.DefaultWorkingDirectory)/drop/*.zip，避免匹配到多余ZIP文件

4. 可选调试步骤 #

如果问题仍存在，可添加临时步骤验证路径正确性：

• 构建流水线归档前添加命令行任务，执行dir $(System.DefaultWorkingDirectory)\WebAppContent，确认输出包含完整站点文件
• 发布流水线部署前添加命令行任务，执行dir $(System.DefaultWorkingDirectory) /s，确认下载的构建产物ZIP包存在且路径正确

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