如何修复Azure Gradle流水线模板的Unexpected value ''错误

错误信息 #

/templates/test-template.yaml (Line: 5, Col: 8): Unexpected value ''

核心问题分析 #

错误源于模板第5行的task未指定具体任务类型，Azure DevOps YAML解析器无法识别空值；同时模板缺少参数声明、存在语法错误，主流水线也有层级缩进问题。

修复后的构建与测试模板（test_template.yaml） #

# 构建与测试模板
parameters:
  - name: app
    type: string
    default: ''
  - name: tag
    type: string
    default: 'appVersion'

jobs:
- job: BuildAndTest
  steps:
  - task: Gradle@2
    inputs: 
      gradleWrapperFile: 'gradlew'  #Gradle包装器文件
      gradleOptions: '-Xmx3072m' # 最大内存
      javaHomeOption: 'JDKVersion'
      jdkVersionOption: '1.11' #Java版本
      jdkArchitectureOption: 'x64' 
      publishJUnitResults: true 
      testResultsFiles: '**/TEST-*.xml'
      tasks: 'build'
  - bash: | 
      echo "Build and run unit tests ${{ parameters.app }}." 
      echo "##vso[task.setvariable variable=${{ parameters.tag }};]$(./gradlew ${{ parameters.app }} -q printVersion)" #构建并运行测试

模板修复点

• 新增parameters块，明确声明app和tag参数，避免未定义参数引发的解析问题
• 给job命名为BuildAndTest，提升流水线可读性
• 给task指定具体任务类型Gradle@2，这是触发错误的核心修复项（原模板task后无任务ID，导致解析为空值）
• 修复bash命令中${{ parameters.app }}}的多余闭合大括号，改为${{ parameters.app }}

修复后的主流水线代码 #

trigger: none

variables:
  - group: azurecr  #Azure容器注册表

pool:
  vmImage: ubuntu-latest

stages:
- stage: test
  jobs:
  - template: templates/test_template.yaml
    parameters:
      app: ':mortgage:mortgage-app:test'
      tag: 'imageTag' # 传递模板所需的tag参数

主流水线修复点

• 修正stage层级缩进：原代码中stage: test未使用列表格式（缺少-），导致层级错误
• 新增tag参数传递，与模板中声明的参数对应
• 给app参数值添加引号，避免特殊字符引发解析异常

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