Azure Synapse/ADF发布管道时提示Env参数定义缺失报错

发布时抛出的无明细报错信息如下：

Error code: OK
Inner error code: BadRequest
Message: Missing parameter definition for Env

问题产生原因 #

这个报错是Synapse发布阶段的全量资源模板校验抛出的，核心原因是工作区master分支下存在引用了名为Env的参数的资源（可能是pipeline、data flow、dataset、linked service任意一种），但该资源的参数定义列表、或者工作区全局参数列表中没有声明Env参数。由于校验逻辑是批量扫描所有资源配置，没有做单资源错误归因，所以不会提示具体出错的资源对象。
常见触发场景包括：

• 在资源中添加了对Env参数的引用逻辑，但忘记在对应资源的参数配置、或者工作区全局参数中声明该参数
• 删除原有Env参数定义时，没有清理掉下游资源中对该参数的引用，残留了无效引用
• 跨环境导入/迁移Synapse资源时，只迁移了参数引用逻辑，漏带了Env的参数定义
• 自定义CI/CD发布流程中，在发布参数文件里额外配置了Env参数的赋值，但Synapse工作区源码中并没有声明这个参数

排查修复步骤 #

• 优先检查全局参数配置
  进入Synapse Studio管理中心，打开「全局参数」配置页，确认是否存在名为Env的参数。如果参数缺失，先补充参数的类型、默认值配置，保存后尝试触发一次发布，确认报错是否消失。
• 全量检索分支源码定位无效引用
  拉取master分支最新的Synapse资源代码到本地，在代码目录下全局搜索以下关键词：parameters('Env')、pipeline().parameters.Env、"Env"。对每一个搜索命中的资源文件，打开对应JSON配置找到parameters节点：
  • 如果该资源不需要使用Env参数，直接删除文件中残留的参数引用逻辑
  • 如果该资源需要保留Env参数的引用，在parameters节点下补充Env的参数定义，明确参数类型、默认值即可
• 校验自定义发布配置（若使用非原生发布流）
  如果是通过CI/CD流水线执行自定义发布，检查发布流程使用的ARM模板参数覆盖配置、参数赋值文件，确认没有额外注入工作区中未定义的Env参数，同时确认工作区中已声明的Env参数在发布配置中有对应合法赋值。
• 最小范围验证
  修复完配置后，先单独保存一个已确认配置正确的资源触发发布，确认校验流程可以正常跑通后，再同步其他修改，避免多问题叠加增加定位成本。

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