Azure Pipelines参数拆分失败致JavaToolInstaller报错求助

问题根源 #

核心原因是Azure Pipelines表达式执行时机不匹配：

• 模板中使用的${{ split(...) }}属于编译时表达式，会在流水线启动前完成解析。
• 主流水线传递给模板的JDK_VERSION: $(JDK_VERSION)是运行时变量引用，编译时还未被替换为实际值1.17，此时split函数处理的是字面量字符串$(JDK_VERSION)，拆分后数组只有一个元素，索引[1]不存在，最终返回空值，触发versionSpec必填项错误。

解决方案：改用运行时处理版本拆分 #

最通用可靠的方式是在运行时提取JDK主版本号，设置为流水线变量后供JavaToolInstaller任务引用。修改模板代码如下：

修改后的模板（install_java.yaml） #

parameters:
  - name: JDK_VERSION  # 值为1.17
    type: string
  - name: JDK_DOWNLOAD_LINK
    type: string

jobs:
- job: J1_Buid_Application
  steps:
  # 提取JDK主版本号并设置为流水线变量
  - bash: |
      # 从参数值中拆分出主版本号（如从1.17提取17）
      JDK_MAJOR_VERSION=$(echo "${{ parameters.JDK_VERSION }}" | cut -d '.' -f 2)
      # 将结果设置为流水线可引用的变量
      echo "##vso[task.setvariable variable=JDK_MAJOR_VERSION]$JDK_MAJOR_VERSION"
    displayName: "🔍 提取JDK主版本号"

  # 下载JDK
  - bash: |
      curl ${{parameters.JDK_DOWNLOAD_LINK}} -L --output jdk.tar.gz
    displayName: "☕ 下载JDK"

  # 安装JDK：引用运行时变量作为versionSpec
  - task: JavaToolInstaller@0
    inputs:
      versionSpec: $(JDK_MAJOR_VERSION)
      jdkArchitectureOption: x64
      jdkSourceOption: LocalDirectory
      jdkFile: jdk.tar.gz
      jdkDestinationDirectory: jdk
    displayName: "☕ 安装JDK"

原理说明 #

1. bash脚本在运行时处理${{ parameters.JDK_VERSION }}（此时参数已被替换为实际的1.17），用cut命令拆分出第二部分的17。
2. 通过Azure Pipelines的##vso[task.setvariable]命令将提取出的版本号设置为流水线变量JDK_MAJOR_VERSION。
3. JavaToolInstaller任务通过$(JDK_MAJOR_VERSION)引用这个运行时变量，确保传入有效的versionSpec值。

备选方案：编译时传递已拆分的版本号（限静态变量） #

如果你的变量组变量是静态值且配置为编译时可见，可以在主流水线中先拆分再传递参数：

修改后的主流水线 #

variables:
- group: MAIN_VARIABLES

stages:
- stage: Install_JDK
  displayName: Build application
  jobs:
  - template: templates/install_java.yaml
    parameters:
      JDK_VERSION: $(JDK_VERSION)
      JDK_MAJOR_VERSION: ${{ split(variables.JDK_VERSION, '.')[1] }}
      JDK_DOWNLOAD_LINK: $(JDK_DOWNLOAD_LINK)

修改后的模板参数 #

parameters:
  - name: JDK_VERSION
    type: string
  - name: JDK_MAJOR_VERSION
    type: string
  - name: JDK_DOWNLOAD_LINK
    type: string

# 后续任务直接引用已拆分的参数
- task: JavaToolInstaller@0
  inputs:
    versionSpec: ${{ parameters.JDK_MAJOR_VERSION }}
    # 其他配置不变

注意：该方案仅适用于变量组变量能在编译时被解析的场景，若变量是动态生成的（如来自其他任务输出），必须使用第一种运行时处理方法。

内容的提问来源于stack exchange，提问作者stefan.stt