Azure Pipeline跨阶段传参后each循环split函数失效问题排查

我需要基于stageDependencies获取的变量执行each循环，但跨阶段传递变量并结合split函数时，循环功能失效。以下是代码示例与输出情况，请问问题出在哪里？

代码示例 #

task.yml #

steps:
  - task: Bash@3
    name: env_string
    inputs:
      targetType: 'inline'
      script: |
        environmentsStr='dev,prd'
        echo "##vso[task.setvariable variable=environmentsString;isOutput=true]$environmentsStr"

pipeline.yml #

- stage: stage1
  jobs:
    - job: job_stage1
      steps:
        - template: tasks.yml

- stage: stage2
  dependsOn:
    - stage1
  variables:
    - name: envFromVar
      value: 'dev,prd'
    - name: envFromStageDependencies
      value: $[ stageDependencies.stage1.job_stage1.outputs['env_string.environmentsString'] ]

  jobs:
    - job: job_stage2
      steps:   
        - template: stage3.yml
          parameters:
            envFromStageDependencies: $(envFromStageDependencies)
            environmentsFromVar: ${{ variables.envFromVar }}

stage3.yml #

parameters:
  - name: envFromStageDependencies
    type: string
  - name: environmentsFromVar
    type: string

steps:
  - ${{ each environment in split(parameters.envFromStageDependencies, ',') }}:
    - bash: |
        echo "env ${{ environment }}" # 输出异常；仅打印env dev,prd

  - ${{ each environment in split(parameters.environmentsFromVar, ',') }}:
    - bash: |
        echo "envVar ${{ environment }}" # 输出正常，循环两次分别打印envVar dev和envVar prd

实际输出 #

• BASH -> env dev,prd
• BASH -> envVar dev
• BASH -> envVar prd

问题原因 #

核心在于Azure DevOps的变量替换时机差异：

• ${{ ... }}属于编译时表达式，在流水线开始运行前就会被解析执行。
• 跨阶段通过stageDependencies传递的变量属于运行时变量，只有在流水线运行到对应阶段时才会被替换为实际值。

当执行split(parameters.envFromStageDependencies, ',')时，parameters.envFromStageDependencies此时还是占位符$(envFromStageDependencies)，而非实际的dev,prd，所以split只会把整个字符串当成一个元素，导致循环仅执行一次。而variables.envFromVar是静态定义的编译时变量，能被split正常解析，因此循环正常工作。

解决方案 #

由于跨阶段变量是运行时解析的，无法通过编译时的each循环处理，建议改用运行时脚本循环：

修改stage3.yml中的第一个步骤，用Bash脚本直接拆分变量并循环：

steps:
  - bash: |
      # 将逗号分隔的字符串拆分为数组
      IFS=',' read -ra env_array <<< "$(envFromStageDependencies)"
      # 遍历数组输出每个环境
      for env in "${env_array[@]}"; do
        echo "env $env"
      done
    displayName: "运行时循环遍历跨阶段传递的环境变量"

  - ${{ each environment in split(parameters.environmentsFromVar, ',') }}:
    - bash: |
        echo "envVar ${{ environment }}"

这样就能正常输出env dev和env prd两次循环结果。

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