Azure Pipelines YAML报错：无法将数组转换为字符串

错误详情 #

/devops/templates/app-deployment-template.yml（第50行，第27列）：Unable to convert from Array to String. Value: Array

问题场景 #

定义了名为locations的参数，类型为object（实际是字符串数组，默认空数组），在AzureResourceManagerTemplateDeployment@3任务的overrideParameters中直接引用该数组参数时触发类型转换错误——Azure Pipelines无法将数组直接转为ARM模板参数所需的字符串格式。

解决方案 #

需要将数组参数拼接为ARM模板认可的字符串格式：

• 若数组元素无空格，直接用空格拼接所有元素
• 若元素包含空格，需为每个元素添加引号后再拼接

修改后的代码片段 #

parameters:
- name: locations
  type: object
  default: [] 
  # 其他参数
  # 其他任务与步骤

  - task: AzureResourceManagerTemplateDeployment@3
    displayName: 'Deploy Azure Core Infrastructure'
    inputs:
      deploymentScope: 'Resource Group'
      azureResourceManagerConnection: '${{parameters.subscriptionName}}'
      action: 'Create Or Update Resource Group'
      resourceGroupName: '${{parameters.environmentName}}-${{parameters.resourceGroupName}}'
      location: 'North Europe'
      templateLocation: 'Linked artifact'
      csmFile: '$(Pipeline.Workspace)/artifacts/infrastructure/appserviceplan.json'
      csmParametersFile: '$(Pipeline.Workspace)/artifacts/infrastructure/appserviceplan.parameters.json'
      deploymentMode: 'Incremental'
      # 元素无空格时用此写法
      overrideParameters: '-name ${{parameters.environmentName}}-${{parameters.resourceGroupName}} -locations ${{ join(' ', parameters.locations) }}'
      # 元素含空格时用此写法
      # overrideParameters: '-name ${{parameters.environmentName}}-${{parameters.resourceGroupName}} -locations "${{ join('" "', parameters.locations) }}"'

补充优化 #

可通过条件判断处理空数组场景，避免传递无效参数：

overrideParameters: >-
  -name ${{parameters.environmentName}}-${{parameters.resourceGroupName}}
  ${{ if not(empty(parameters.locations)) }}:
    -locations ${{ join(' ', parameters.locations) }}

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