Azure YAML Pipeline模板脚本执行时触发Template Expression Error

常见原因及对应修复方案 #

1. 脚本内容中错误使用模板表达式 #

bash脚本步骤属于运行时执行上下文，不能直接使用${{ variables.xxx }}或${{ parameters.xxx }}这类模板表达式，需改用运行时变量语法$VARIABLE_NAME或$(variableName)。

错误示例：

steps:
- bash: |
    echo "当前环境：${{ variables.environment }}"
  displayName: '打印环境信息'

修复后：

steps:
- bash: |
    echo "当前环境：$ENVIRONMENT"
    # 或使用Azure Pipeline标准运行时语法
    echo "当前环境：$(environment)"
  displayName: '打印环境信息'

2. Condition属性中的表达式语法错误 #

Condition支持模板表达式，但必须是完整的单表达式，不能拆分多个${{ ... }}块，也不要混用模板表达式${{ ... }}和运行时表达式$[ ... ]。

错误示例：

steps:
- bash: '执行验证步骤'
  condition: ${{ eq(variables.buildReason, 'Manual') }} && ${{ parameters.runValidation }}
  # 错误：模板表达式被拆分为多个块，需合并为一个完整表达式

修复后：

steps:
- bash: '执行验证步骤'
  condition: ${{ eq(variables.buildReason, 'Manual') && parameters.runValidation }}

若需引用运行时动态变量，改用$[ ... ]语法：

steps:
- bash: '执行验证步骤'
  condition: $[ eq(variables.buildReason, 'Manual') ]

3. 不支持的属性中使用模板表达式 #

部分步骤属性或参数定义不允许使用模板表达式，比如模板参数的默认值只能用常量或其他参数，不能引用变量。

错误示例：

parameters:
  - name: workingDir
    type: string
    default: ${{ variables.defaultWorkingDir }} # 错误：参数默认值无法通过模板表达式引用变量

修复后：

parameters:
  - name: workingDir
    type: string
    default: 'src' # 使用常量作为默认值
# 调用模板时传递变量值
jobs:
- job: Validate
  steps:
  - template: templates/Apps/validate/push_requirements_global.yaml@templates
    parameters:
      workingDir: $(defaultWorkingDir)

4. 模板嵌套时的表达式冲突 #

若模板嵌套了其他模板，需检查父、子模板的参数传递是否正确，确保子模板中使用的表达式仅在允许的上下文内。

针对第21行的具体排查 #

定位模板第21行内容，重点检查：

• 是否在bash脚本中使用了${{ ... }}，若是直接替换为运行时变量语法
• 若是condition属性，确认表达式是否为完整的单块模板表达式，无拆分或语法错误
• 是否在参数/变量定义中违规使用模板表达式

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