Azure Data Factory YAML部署时overrideParameters含空格键报错咨询

异常场景 #

使用Azure DevOps的AzureResourceManagerTemplateDeployment@3任务自动部署ADF实例时，若Override参数的键名包含空格，会抛出解析错误：

There was an error while overriding [my-parameter] parameter because of 'TypeError: Cannot read property 'type' of undefined', make sure it follows JavaScript Object Notation (JSON)

经验证，移除该带空格的Override参数后，部署流程可正常运行。这类带空格的参数名是ADF发布分支自动生成的——只要ADF内的管道、触发器等实体命名包含空格，自动生成的ARM参数键就会嵌入对应实体名的空格，用户既不能修改ADF自动生成的参数命名规则，也不想通过自定义ARM模板绕过该问题。

已尝试的无效配置 #

针对带空格的参数键，以下写法均无法通过解析：

• 裸键无引号：-AAS-Shutdown-Trigger_properties_AAS Shutdown_parameters_AASServerName
• 双引号包裹键名：-"AAS-Shutdown-Trigger_properties_AAS Shutdown_parameters_AASServerName"
• 单引号包裹键名：-'AAS-Shutdown-Trigger_properties_AAS Shutdown_parameters_AASServerName'
• 方括号嵌套双引号：-["AAS-Shutdown-Trigger_properties_AAS Shutdown_parameters_AASServerName"]
• 方括号嵌套单引号：-['AAS-Shutdown-Trigger_properties_AAS Shutdown_parameters_AASServerName']

根因说明 #

AzureResourceManagerTemplateDeployment@3任务对overrideParameters字段的解析采用类Shell的空分隔逻辑：未转义的空格会被识别为不同参数之间的分隔符。当参数键本身包含未转义的空格时，完整的参数键会被拆分为多段独立内容，最终无法匹配ARM模板内定义的完整参数键，触发参数类型未定义的报错。

有效修复配置 #

仅需要将参数键内部的空格做反斜杠转义，不需要额外给键名加外层引号包裹，修改后的管道配置示例：

- task: AzureResourceManagerTemplateDeployment@3
  displayName: 'ARM Template deployment'
  inputs:
    deploymentScope: 'Resource Group'
    azureResourceManagerConnection: ${{ variables.azureSubscription }}
    subscriptionId: ${{ variables.subscriptionId }}
    action: 'Create Or Update Resource Group'
    resourceGroupName: ${{ variables.resourceGroupName }}
    location: 'West Europe'
    templateLocation: 'Linked artifact'
    csmFile: '$(System.DefaultWorkingDirectory)/adf_branch/${{ variables.dataFactoryRepoPath }}/ARMTemplateForFactory.json'
    csmParametersFile: '$(System.DefaultWorkingDirectory)/adf_branch/${{ variables.dataFactoryRepoPath }}/ARMTemplateParametersForFactory.json'
    overrideParameters: >-
      -factoryName "${{ variables.dataFactoryName }}"
      -AAS-Shutdown-Trigger_properties_AAS\ Shutdown_parameters_AASServerName "${{ variables.aasShutdownServer }}"
    deploymentMode: 'Incremental'

关键调整：将原参数键中AAS Shutdown之间的普通空格，替换为反斜杠转义的空格（即AAS\ Shutdown），让解析器将转义后的空格识别为键名的组成部分，而非参数分隔符。

注意事项 #

• 转义完成后不要给参数键加外层双/单引号，否则解析器会把引号字符识别为键名的一部分，依然无法匹配ARM模板中的对应参数
• 该方案不需要修改ADF自动生成的ARM模板、参数文件结构，也不需要调整ADF内的实体命名规则，完全适配不改动自动生成配置的要求
• 该解析规则仅支持AzureResourceManagerTemplateDeployment@3及以上版本的部署任务，低版本任务不支持转义空格的参数识别逻辑

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