Azure DevOps IIS部署：文件转换生效但部署后仍用原web.config

我在使用Azure DevOps部署IIS应用时遇到文件转换异常：文件转换流程已执行完成，WebApp.zip中能看到转换后的正确web.config，但部署完成后IIS站点目录里的web.config还是预转换的原始值。

已确认的配置与现象 #

发布流程文件转换配置 #

IIS Web应用部署配置 #

发布执行日志验证 #

• 执行Release时，日志显示已读取web.qa.config完成对web.config的转换
  
• 部署阶段显示的源文件为转换后的WebApp.zip
  

服务器端验证 #

• 在Web服务器上打开部署包WebApp.zip，里面的web.config转换结果正确
  
• 但IIS部署目录中的web.config仍是预转换的原始值
  
• 手动删除IIS目录的web.config后重新发布，日志显示已添加该文件，但最终目录里的文件还是旧值，全程部署无错误提示且显示成功完成。

可能的排查方向与解决方法 #

1. 检查IIS部署任务的文件替换配置
   确认IIS Web应用部署任务中是否开启了**"XML变量替换"或"文件替换"**功能，这类功能可能会覆盖已转换好的web.config。如果不需要额外替换，建议暂时关闭这两个选项重试。

2. 验证部署路径与IIS站点目录一致性
   核对Azure DevOps部署任务设置的目标路径，是否和IIS站点的物理路径完全匹配。避免出现部署包解压到其他目录，而IIS仍指向旧目录的情况。

3. 排查文件锁定与权限问题

   • 用Process Explorer工具检查web.config是否被IIS进程或其他程序锁定，锁定状态会导致文件无法替换，可重启IIS后重新部署。
   • 确认部署服务账户对IIS站点目录拥有完全控制权限，权限不足可能导致文件替换失败但不抛出错误。

4. 检查MSDeploy附加参数
   查看部署任务中的"附加参数"是否包含跳过web.config替换的规则（比如-skip:objectName=configFile），如有则移除该参数。

5. 启用详细日志定位问题
   在IIS Web应用部署任务中开启**"启用详细日志记录"**，重新部署后查看日志里关于web.config的处理细节，确认是否存在被跳过或异常替换的情况。

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