Azure Data Factory DevOps部署中ARM模板参数含空格问题排查

1. 检查ADF自动生成的ARM文件 #

ADF发布后会生成ARMTemplateForFactory.json和ARMTemplateParametersForFactory.json，这俩文件是异常参数的高发区：

• 直接打开文件搜索带空格的参数名（比如"数据源 名称"这类格式）
• 重点排查数据集、链接服务的参数化配置，ADF常会把带空格的资源名自动转成带空格的参数
• 检查参数文件的格式错误，比如逗号后误加空格、多余空行导致的解析异常

2. 检查DevOps部署任务的配置 #

• 打开流水线的ARM部署任务，查看「覆盖模板参数」输入框的历史内容，确认是否有残留的带空格参数
• 切换到「代码视图」查看YAML配置，找到overrideParameters字段，排查是否存在格式错误的参数，比如：

  overrideParameters: '-"param with space" test'
  

  正确处理方式是将参数名改为无空格格式，或者严格用引号包裹参数和值：-"paramWithSpace" "test"

3. 排查ADF内部的参数化设置 #

• 登录ADF Studio，检查所有参数、数据集、链接服务的名称，确保完全无空格（包括中文空格）
• 进入「管理」->「ARM模板」->「自定义参数」，确认是否存在手动添加或自动生成的带空格参数
• 重新发布ADF时勾选「只发布已更改的资源」，避免旧的异常参数被重复带入

4. 清理DevOps的缓存和旧记录 #

• 删除流水线历史中失败的部署记录，防止缓存的异常参数被复用
• 重新拉取仓库代码，确保本地与远程的ARM文件完全一致，无旧版本残留

5. 手动修复并验证 #

• 找到带空格的参数后，直接在参数文件中将空格替换为下划线或驼峰命名（比如"my parameter"改为"myParameter"）
• 同步修改模板文件中对应的参数引用，保证模板与参数的键名完全匹配
• 本地用Azure CLI验证文件合法性：

  az deployment group validate --resource-group <你的资源组名> --template-file ./ARMTemplateForFactory.json --parameters ./ARMTemplateParametersForFactory.json
  

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