Azure DevOps中合并列表属性后无法正确迭代的问题咨询

问题描述 #

当将字符串列表作为对象参数的属性，与另一个独立字符串列表参数合并时，Azure DevOps无法正确解析该字符串列表，触发类型转换错误：/azure-pipelines.yml (Line: 19, Col: 17): Unable to convert from Object to String. Value: Object。实际应作为字符串的变量n被错误识别为对象，JSON序列化后显示为{"lit":"name1"...}。

可行场景 #

场景1：合并两个独立字符串列表参数 #

parameters:
- name: group
  type: object
  default:
  - 'myGroup'
- name: resourceNames
  type: object
  default:
  - 'name1'
  - 'name2'

jobs:
- job: TestJob

  steps:  
  - ${{ each n in coalesce(parameters.resourceNames, parameters.group) }}:
    - script: echo ${{ n }}

该配置正常生成2个脚本任务，分别输出name1和name2。

场景2：迭代对象列表参数的列表属性 #

parameters:
- name: resources
  type: object
  default:
  - resourceNames:
    - 'name1'
    - 'name2'

jobs:
- job: TestJob

  steps:  
  - ${{ each r in parameters.resources }}:
    - ${{ each n in r.resourceNames}}:
      - script: echo ${{ n }}

该配置同样正常生成2个脚本任务，输出name1和name2。

不可行场景：合并对象列表属性与独立字符串列表 #

parameters:
- name: group
  type: object
  default:
  - 'myGroup'
- name: resources
  type: object
  default:
  - resourceNames:
    - 'name1'
    - 'name2'

jobs:
- job: TestJob

  steps:  
  - ${{ each r in parameters.resources }}:
    - ${{ each n in coalesce(r.resourceNames, parameters.group) }}:
      - script: echo ${{ n }}

此配置触发上述类型转换错误，无法正常执行。

解决方案 #

方案1：通过临时变量完成合并 #

将合并后的列表赋值给临时变量，让Azure DevOps正确识别元素类型：

parameters:
- name: group
  type: object
  default:
  - 'myGroup'
- name: resources
  type: object
  default:
  - resourceNames:
    - 'name1'
    - 'name2'

jobs:
- job: TestJob
  variables:
    ${{ each r in parameters.resources }}:
      mergedNames_${{ index(parameters.resources, r) }}: ${{ coalesce(r.resourceNames, parameters.group) }}

  steps:  
  - ${{ each r in parameters.resources }}:
    - ${{ each n in variables['mergedNames_${{ index(parameters.resources, r) }}'] }}:
      - script: echo ${{ n }}

方案2：用条件判断替代coalesce #

通过显式条件判断选择要迭代的列表，避免类型解析问题：

parameters:
- name: group
  type: object
  default:
  - 'myGroup'
- name: resources
  type: object
  default:
  - resourceNames:
    - 'name1'
    - 'name2'

jobs:
- job: TestJob

  steps:  
  - ${{ each r in parameters.resources }}:
    - ${{ if r.resourceNames }}:
      - ${{ each n in r.resourceNames }}:
        - script: echo ${{ n }}
    - ${{ else }}:
      - ${{ each n in parameters.group }}:
        - script: echo ${{ n }}

关于是否为Bug的说明 #

这属于Azure DevOps YAML模板引擎在处理嵌套对象属性与coalesce函数结合时的类型解析缺陷——引擎未正确识别coalesce返回的列表元素类型，错误将字符串解析为内部语法对象（lit类型节点）。目前官方未将其标记为Bug，但通过上述方案可绕过该问题。

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