多环境CI/CD流水线后续环境部署被跳过问题求助

我正在构建的CI/CD流水线包含以下核心步骤：

1. 检测代码是否存在变更
2. 若检测到变更则执行部署操作

该流水线用于多环境部署场景，但遇到了异常问题：首个环境（如Dev）部署完全符合预期，但后续环境（如Uat、Prod）即使检测到变更，部署阶段仍会被标记为“skipped”。

补充问题细节 #

• 仅首个环境能正常运行，后续环境哪怕明确检测到变更也无法触发部署；第三个环境（Prod）在中间阶段无变更时同样无法执行部署流程。
• 当两个环境中首个环境无变更时，第二个环境的apply阶段也会被直接跳过，无法执行部署。
• 即使注释掉apply阶段的depends on:配置，问题依然存在。

流水线配置代码 #

主流水线配置 #

trigger:
  batch: true
  branches:
    include:
      - main

pr:
  branches:
    include:
      - main

stages:
- template: templates/deploy.yml
  parameters:
    environment: Dev

- template: templates/deploy.yml
  parameters:
    environment: Uat

deploy.yml模板配置 #

stages:
- stage: Terraform_Plan_${{ parameters.environment }}
  displayName: Plan
  condition: always()
  jobs:
  - job: Terraform_Plan_${{ parameters.environment }}
    displayName: Plan Terraform
    pool: 'selfhosted'
    steps:

    - powershell: |
          # set it to true or false
          Write-Host "##vso[task.setvariable variable=anyTfChanges;isOutput=true]true"

      displayName: Detect any Terraform changes
      name: anyTfChanges


- stage: Any_Tf_Changes_${{ parameters.environment }}
  displayName: Terraform Changes
  dependsOn: Terraform_Plan_${{ parameters.environment }}
  variables:
     anyTfChanges: $[ stageDependencies.Terraform_Plan_${{ parameters.environment }}.Terraform_Plan_${{ parameters.environment }}.outputs['anyTfChanges.anyTfChanges'] ]
  condition: and(eq('true', 'true'), eq(dependencies.Terraform_Plan_${{ parameters.environment }}.outputs['Terraform_Plan_${{ parameters.environment }}.anyTfChanges.anyTfChanges'], 'true'))
 
  jobs:
    - job: Terraform_Changes_${{ parameters.environment }}
      displayName: Detect Terraform Changes
      steps:
      - checkout: none
      - powershell: |
          Write-Host "hello world"
        displayName: Terraform changes detected

- stage: Terraform_Apply_${{ parameters.environment }}
  displayName: Apply ${{ parameters.environment }}
  dependsOn: Any_Tf_Changes_${{ parameters.environment }}
  jobs:
  - deployment: Apply
    environment: ${{ parameters.environmentDisplayName }}
    displayName: Apply Terraform
    pool: 'selfhosted'
    strategy:
      runOnce:
        deploy:
          steps:
          - checkout: self
          - script: |
              Write-Host "hello world"

排查思路与修复建议 #

1. 阶段条件中的变量引用错误 #

在Any_Tf_Changes_${{ parameters.environment }}阶段的condition中，混用了dependencies和stageDependencies的语法，同时存在冗余判断：

• 跨阶段引用输出变量必须使用stageDependencies而非dependencies
• eq('true', 'true')是无意义的冗余判断，可直接删除

修改后的condition应为：

condition: eq(stageDependencies.Terraform_Plan_${{ parameters.environment }}.Terraform_Plan_${{ parameters.environment }}.outputs['anyTfChanges.anyTfChanges'], 'true')

2. 环境参数不匹配 #

在Terraform_Apply_${{ parameters.environment }}阶段的部署任务中，使用了${{ parameters.environmentDisplayName }}参数，但主流水线调用模板时仅传递了environment参数，未传递environmentDisplayName，会导致环境名称为空，触发跳过逻辑。

修改为：

environment: ${{ parameters.environment }}

3. 阶段跳过的连锁影响 #

当Any_Tf_Changes阶段因条件不满足被跳过，后续Terraform_Apply阶段会默认因依赖阶段被跳过而同步跳过。建议给Terraform_Apply阶段直接添加变更判断条件，不再依赖中间阶段的执行状态：

stage: Terraform_Apply_${{ parameters.environment }}
displayName: Apply ${{ parameters.environment }}
dependsOn: Terraform_Plan_${{ parameters.environment }}
condition: eq(stageDependencies.Terraform_Plan_${{ parameters.environment }}.Terraform_Plan_${{ parameters.environment }}.outputs['anyTfChanges.anyTfChanges'], 'true')

4. 验证阶段命名唯一性 #

虽然用${{ parameters.environment }}作为阶段命名后缀，但建议检查流水线运行时的阶段名称是否完全唯一，避免Azure DevOps解析依赖时出现混淆。

5. 快速验证排查 #

可暂时将Any_Tf_Changes阶段的condition改为always()，验证后续Apply阶段是否能正常触发，以此确认是条件判断问题还是依赖逻辑问题。

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