Azure DevOps Pipeline任务空字符串条件判断失效问题排查

问题场景 #

我有一个Azure DevOps Pipeline模板，接收gitTag参数（默认值为空格），需要处理三种输入场景：

• 用户未输入任何内容
• 用户仅输入任意长度空格
• 用户输入前后带空格的有效值（需修剪后使用）

模板中第一个PowerShell任务负责修剪参数并设置为变量trimmedGitTag，第二个任务设置了条件：仅当前序任务成功且修剪后的变量不为空时执行。但实际执行时，即使第一个任务输出Trimed parameter = ''，第二个任务仍会执行。

原模板代码：

parameters:
  gitTag: ' '

stages:
- stage: CreationTag

  jobs:
  - job: Tag
    pool:
      name: Default

    steps:

    - task: PowerShell@2
      displayName: 'gitTag parameter trim'
      inputs:
        targetType: 'inline'
        script: | 
          $trimmedGitTag = "${{parameters.gitTag}}".Trim()
          Write-Host "##vso[task.setvariable variable=trimmedGitTag]$trimmedGitTag"
          Write-Output "Trimed parameter = '$trimmedGitTag'"
      
    - task: PowerShell@2
      displayName: 'Creation du tag Git'      
      inputs:
        targetType: 'inline'
        script: |
          Write-Output "Trimed parameter = '$(trimmedGitTag)'"
      condition: and(succeeded(), ne('$(trimmedGitTag)', ''))

问题原因 #

核心问题是变量替换时机不匹配：
模板中使用$(trimmedGitTag)属于宏替换语法，宏替换在Pipeline的编译阶段完成，但trimmedGitTag是通过运行时任务设置的变量，编译阶段该变量尚未存在，宏替换后会被解析为空字符串。此时条件表达式ne('', '')本应返回false，但Azure DevOps对空变量的宏替换处理存在歧义，导致条件被误判为true，最终触发第二个任务执行。

解决方案 #

方案一：编译阶段直接修剪参数（推荐） #

利用Azure DevOps内置的编译阶段函数trim()，直接在变量定义中完成参数修剪，无需运行时任务，条件判断更准确高效：

parameters:
  gitTag: ' '

# 编译阶段修剪参数，生成最终可用的trimmedGitTag变量
variables:
  trimmedGitTag: ${{ trim(parameters.gitTag) }}

stages:
- stage: CreationTag
  jobs:
  - job: Tag
    pool:
      name: Default
    steps:
    - task: PowerShell@2
      displayName: '创建Git标签'      
      inputs:
        targetType: 'inline'
        script: |
          Write-Output "修剪后的参数 = '$(trimmedGitTag)'"
          # 此处添加实际创建Git标签的逻辑
      condition: and(succeeded(), ne('$(trimmedGitTag)', ''))

方案二：运行时变量的正确条件判断 #

如果必须在运行时处理参数，修改条件表达式为运行时变量引用语法，确保变量值在任务执行前被正确解析：

parameters:
  gitTag: ' '

stages:
- stage: CreationTag
  jobs:
  - job: Tag
    pool:
      name: Default
    steps:
    - task: PowerShell@2
      displayName: 'gitTag参数修剪'
      inputs:
        targetType: 'inline'
        script: | 
          $trimmedGitTag = "${{parameters.gitTag}}".Trim()
          Write-Host "##vso[task.setvariable variable=trimmedGitTag]$trimmedGitTag"
          Write-Output "修剪后的参数 = '$trimmedGitTag'"
      
    - task: PowerShell@2
      displayName: '创建Git标签'      
      inputs:
        targetType: 'inline'
        script: |
          Write-Output "修剪后的参数 = '$(trimmedGitTag)'"
          # 此处添加实际创建Git标签的逻辑
      # 使用运行时变量引用语法，替换原宏替换方式
      condition: and(succeeded(), ne(variables['trimmedGitTag'], ''))

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