Azure DevOps发布管道Replace Token任务未替换文件令牌求助

• 检查Replace Token任务的目标文件路径

  • 确认任务指定的路径是解压后的config.json文件，而非原zip包。例如解压目录为$(System.DefaultWorkingDirectory)/unpacked，则路径需设为**/unpacked/config.json
  • 查看任务日志的「处理文件」条目，确认匹配到的文件数不为0，且路径正确

• 验证变量配置与令牌格式

  • 确认变量组已关联到当前发布环境，且apiURL变量值正确（检查发布管道「变量」标签）
  • 核对Replace Token任务的「Token prefix」和「Token suffix」是否为#{和}#，与文件内的#{apiURL}#格式完全匹配

• 确认重新压缩与部署的文件一致性

  • 重新压缩任务需以替换后的解压目录为源，而非原始zip包
  • 部署任务（如IIS Web App Deploy）的「Package or folder」需指向新生成的zip，而非原始制品路径（如$(Pipeline.Workspace)下的原文件）

• 排查服务器端文件问题

  • 重启对应IIS应用池/网站，避免文件被缓存或进程锁定
  • 开启部署任务的「Take app offline」选项，确保旧文件能被正常覆盖

• 增加中间验证步骤定位问题

  • 替换后、压缩前添加PowerShell任务，输出config.json内容确认替换生效：

    Get-Content $(System.DefaultWorkingDirectory)/unpacked/config.json
    

  • 压缩后临时解压新zip，检查内部config.json是否已更新，排除压缩环节故障

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