Azure DevOps中Replacetokens@6任务令牌未替换问题排查请求

问题现象 #

使用Azure DevOps流水线执行令牌替换测试，所有任务执行状态显示成功，但最终打印文件时发现令牌未被替换，仍保留初始值test02。调整文件路径和名称后问题依旧。

原流水线YAML配置 #

rigger:

main
pool:
vmImage: ubuntu-latest

parameters:

name: TestSetting
default: testSet01
values:
testSet01
testSet02
testSet03
stages:

stage: A
jobs:

job: A1
steps:
task: Bash@3
displayName: 'Set variable'
inputs:
targetType: inline
script: |
echo 'The selected TestSetting is ${{ parameters. TestSetting }}.'
echo "##vso[task.setvariable variable=TestSettings_Name;] ${{ parameters. TestSetting }}"
task: Bash@3
displayName: 'Print file before replace'
inputs:
targetType: inline
script: 'cat $(System.DefaultWorkingDirectory)/appsettings.json'

task: Bash@3
inputs:
targetType: 'inline'
script: 'echo $(TestSetting_Name)'

task: Bash@3
inputs:
targetType: 'inline'
script: 'cat $(System.DefaultWorkingDirectory)/appsettings.json'

task: replacetokens@6
inputs:
root: '$(System.DefaultWorkingDirectory)'
sources: 'appsettings.json'

task: Bash@3
displayName: 'Print file after replace'
inputs:
targetType: inline
script: 'cat $(System.DefaultWorkingDirectory)/appsettings.json'

核心问题排查与修复 #

1. YAML语法错误 #

• 触发器拼写错误：第一行rigger:应为trigger:，拼写错误会导致流水线配置解析异常，影响后续变量和任务执行逻辑。
• Parameters格式违规：parameters块缩进不符合YAML规范，values下的选项需缩进一级，正确格式应为：

  parameters:
    - name: TestSetting
      default: testSet01
      values:
        - testSet01
        - testSet02
        - testSet03
  

• 参数引用空格问题：脚本中${{ parameters. TestSetting }}包含多余空格，应改为${{ parameters.TestSetting }}，否则无法正确读取参数值。

2. 变量名拼写不一致 #

设置变量时使用的是TestSettings_Name（末尾多一个s），但后续echo和令牌替换引用的是TestSetting_Name，变量名不匹配导致无法读取正确值，令牌自然无法替换。需统一变量名，示例：

echo "##vso[task.setvariable variable=TestSetting_Name;] ${{ parameters.TestSetting }}"

3. Replacetokens任务配置缺失 #

默认情况下，replacetokens@6任务的令牌格式为__{变量名}__（双下划线包裹）。如果你的appsettings.json中令牌使用其他格式（比如#{TestSetting_Name}#），需显式配置前缀和后缀：

task: replacetokens@6
inputs:
  root: '$(System.DefaultWorkingDirectory)'
  sources: 'appsettings.json'
  tokenPrefix: '#{'  # 根据实际令牌前缀调整
  tokenSuffix: '}#'  # 根据实际令牌后缀调整

同时确保appsettings.json中的令牌名称与流水线变量名完全一致。

修正后的完整YAML示例 #

trigger:
  - main
pool:
  vmImage: ubuntu-latest

parameters:
  - name: TestSetting
    default: testSet01
    values:
      - testSet01
      - testSet02
      - testSet03

stages:
  - stage: A
    jobs:
      - job: A1
        steps:
          - task: Bash@3
            displayName: 'Set variable'
            inputs:
              targetType: inline
              script: |
                echo 'The selected TestSetting is ${{ parameters.TestSetting }}.'
                echo "##vso[task.setvariable variable=TestSetting_Name;] ${{ parameters.TestSetting }}"
          - task: Bash@3
            displayName: 'Print file before replace'
            inputs:
              targetType: inline
              script: 'cat $(System.DefaultWorkingDirectory)/appsettings.json'
          - task: Bash@3
            displayName: 'Verify variable value'
            inputs:
              targetType: 'inline'
              script: 'echo $(TestSetting_Name)'
          - task: replacetokens@6
            displayName: 'Replace tokens in appsettings'
            inputs:
              root: '$(System.DefaultWorkingDirectory)'
              sources: 'appsettings.json'
              # 根据实际令牌格式调整以下参数
              tokenPrefix: '__'
              tokenSuffix: '__'
          - task: Bash@3
            displayName: 'Print file after replace'
            inputs:
              targetType: inline
              script: 'cat $(System.DefaultWorkingDirectory)/appsettings.json'

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