Azure DevOps模板作业参数依赖问题：管道未使用传入参数报错

错误信息 #

加载YAML构建管道时发生错误，表达式and(succeeded(), ne(dependencies..outputs['diff.no_diff'], 'true'))的第34位存在意外符号'.'。

问题根源 #

模板中parameters.name的默认值设为空字符串，当模板渲染时，若参数传递环节出现问题（比如漏传、拼写错误），会导致dependencies.${{ parameters.name }}.outputs被解析成dependencies..outputs，连续的点违反了YAML表达式语法规则，触发加载错误。

解决方案 #

方案1：强制必填name参数 #

直接移除name参数的默认空字符串，要求调用模板时必须传入有效值，从根源避免空值问题。

修正后的模板代码（templates/microservice-release.yaml）：

parameters:
  - name: microservice
    default: ''
  - name: name
    # 移除默认空字符串，强制调用时必须传入
jobs:
- job: ${{ parameters.name }}
  displayName: Check for Changes
  pool:
    name: MyPool
  steps:
  - checkout: self
    clean: true
  - bash: |
      if git diff --quiet HEAD~ HEAD ${{ parameters.microservice }}; then
        echo "##[section]No changes Found in ${{ parameters.microservice }}"
        echo "##vso[task.setvariable variable=no_diff;isOutput=true]true"
      else
        echo "##[section]There are changes. Build is required."
      fi
    name: diff
      
- job:
  dependsOn:
  - ${{ parameters.name }}
  condition: and(succeeded(), ne(dependencies.${{ parameters.name }}.outputs['diff.no_diff'], 'true'))
  displayName: ${{ parameters.microservice }}

方案2：添加空值判断兼容空参数场景 #

如果需要保留参数默认值，可以在条件表达式中先判断parameters.name是否为空，避免生成无效表达式：

修正后的模板条件表达式部分：

condition: >-
  and(
    succeeded(),
    not(eq('${{ parameters.name }}', '')),
    ne(dependencies.${{ parameters.name }}.outputs['diff.no_diff'], 'true')
  )

同时注意调用模板时的缩进规范（YAML对缩进敏感），修正后的调用代码：

trigger:
- Mybranch

jobs:
  - template: templates/microservice-release.yaml
    parameters:
      name: microservice1
      microservice: 'microservice1'

  - template: templates/microservice-release.yaml
    parameters:
      name: microservice2
      microservice: 'microservice2'

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