Azure DevOps ReplaceTokensV5任务未正常替换令牌，请求排查

常见问题点和解决办法 #

1. 变量没传到部署阶段 #

构建阶段能用的变量，部署阶段未必能直接拿到。

• 先确认部署阶段能读到IMAGE_NAME：加个Bash/PowerShell任务打印变量看看，比如：

  echo $(IMAGE_NAME)
  

• 如果是跨阶段传变量，得在构建阶段把变量设成输出变量，部署阶段用特定格式引用。比如构建阶段这么写：

  - task: Bash@3
    name: setImageVar
    inputs:
      targetType: 'inline'
      script: |
        echo "##vso[task.setvariable variable=IMAGE_NAME;isOutput=true]your-image-name"
  

  部署阶段引用的时候要写成$(setImageVar.IMAGE_NAME)。

2. ReplaceTokens任务参数配错了 #

部署阶段的任务参数可能和构建阶段不一样，导致认不出{{}}格式的令牌。

• 你用的是{{IMAGE_NAME}}，但ReplaceTokensV5默认认的是#{token}#，所以得手动指定令牌格式：把tokenPattern设为custom，再填tokenPrefix: '{{'和tokenSuffix: '}}'。示例配置：

  - task: ReplaceTokensV5@5
    inputs:
      rootDirectory: '$(System.DefaultWorkingDirectory)/your-yaml-folder'
      targetFiles: 'your-target-file.yaml'
      tokenPattern: 'custom'
      tokenPrefix: '{{'
      tokenSuffix: '}}'
      writeBOM: false
      encoding: 'auto'
  

• 还要检查文件路径：部署阶段的工作目录可能和构建阶段不一样，别用相对路径，尽量用$(Pipeline.Workspace)或者绝对路径指定文件位置。

3. 目标文件没找到或没权限 #

部署阶段可能根本没拿到要替换的YAML文件，或者没权限读。

• 看任务日志里的文件路径，确认是不是和实际文件位置对得上。
• 构建阶段先把YAML文件发布成工件，部署阶段先下载再替换。比如构建阶段加：

  - task: PublishBuildArtifacts@1
    inputs:
      PathtoPublish: 'path-to-your-yaml'
      ArtifactName: 'yaml-configs'
      publishLocation: 'Container'
  

  部署阶段先下载：

  - task: DownloadBuildArtifacts@0
    inputs:
      buildType: 'current'
      downloadType: 'single'
      artifactName: 'yaml-configs'
      downloadPath: '$(System.DefaultWorkingDirectory)'
  

4. 变量被覆盖或没设对 #

部署阶段可能有同名变量把构建阶段的值盖了，或者变量没配置到部署阶段的作用域里。

• 检查变量的作用域：确保IMAGE_NAME的作用域包含部署阶段，或者直接在部署阶段单独定义这个变量。
• 如果是秘密变量，ReplaceTokens默认不会替换，要么取消秘密标记（如果不需要保密），要么确认任务有权限访问秘密变量。

快速排查步骤 #

1. 在ReplaceTokens任务前面加个任务，打印IMAGE_NAME的值和目标YAML文件的内容，确认变量存在、文件里确实有{{IMAGE_NAME}}。
2. 把构建阶段的ReplaceTokens配置复制到部署阶段，确保参数完全一致，再测试。
3. 确认部署阶段的工作目录里有目标YAML文件。

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