Azure DevOps同作业模板间传递输出变量遇参数无效错误

错误原因 #

1. 模板参数验证时机冲突：Git Tag模板中semVersion参数的values枚举限制在管道编译阶段生效，但你传递的$(Type.Semversion)是运行时输出变量，编译时该变量还未生成具体值，因此被判定为无效值，触发The semVersion parameter value is not a valid value错误。
2. 变量名大小写错误：Semantic Version模板输出的变量名是semVersion（小写v），但你引用时写的是$(Type.Semversion)（大写V），Azure DevOps变量名区分大小写，这会导致变量值为空，进一步引发参数无效问题。

解决方案 #

步骤1：修正变量引用的大小写 #

先将Git Tag模板的参数引用改为正确的大小写：

jobs:
  - job: job_git_tag
    displayName: 打新版本标签

    steps:
      - template: /templates/git/semantic_version_type.yaml
        parameters:
          semVersion: ${{ parameters.semVersion }}
      
      - template: /templates/git/git_tag.yaml
        parameters:
          module: ${{ parameters.module }}
          semVersion: $(Type.semVersion) # 修正为小写v

步骤2：调整Git Tag模板的参数验证逻辑 #

由于运行时变量无法通过编译阶段的枚举验证，需将枚举验证从模板参数层面移至运行时步骤中：

修改后的Git Tag模板：

parameters:
  - name: module
    type: string
  - name: semVersion
    type: string
    default: patch

steps:
  - bash: |
      # 运行时验证semVersion是否为合法值
      valid_values=("major" "minor" "patch")
      if [[ ! " ${valid_values[@]} " =~ " $SEM_VERSION " ]]; then
        echo "##vso[task.logissue type=error]semVersion参数值无效，必须是major、minor或patch中的一个"
        exit 1
      fi
      # 执行打标签逻辑
      echo "开始为模块${MODULE}打${SEM_VERSION}版本标签..."
    displayName: 验证版本类型并打标签
    env:
      SEM_VERSION: ${{ parameters.semVersion }}
      MODULE: ${{ parameters.module }}

可选：保留参数枚举验证的替代方案 #

若必须保留Git Tag模板的参数枚举限制，可将两个步骤拆分到不同作业中，通过作业输出变量传递值（跨作业的变量传递会在编译阶段被识别为合法占位符）：

jobs:
  - job: get_sem_version
    displayName: 获取语义化版本类型
    steps:
      - template: /templates/git/semantic_version_type.yaml
        parameters:
          semVersion: ${{ parameters.semVersion }}
    # 声明作业输出变量
    outputs:
      semVersion: ${{ steps.Type.outputs.semVersion }}

  - job: git_tag
    displayName: 打新版本标签
    dependsOn: get_sem_version
    variables:
      semVersionFromPrevJob: $[ dependencies.get_sem_version.outputs['semVersion'] ]
    steps:
      - template: /templates/git/git_tag.yaml
        parameters:
          module: ${{ parameters.module }}
          semVersion: ${{ variables.semVersionFromPrevJob }}

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