Azure DevOps Pipeline发布ADF移除用户分配托管标识致部署报错

这是Azure Data Factory跨环境CI/CD部署的高发问题，核心诱因是默认生成的部署模板未覆盖托管标识配置，叠加部署模式配置错误：

• 若Pipeline里ARM部署任务使用完整（Complete）部署模式，部署动作会直接清除目标ADF上所有未在模板中声明的配置，包括提前绑定好的用户分配托管标识（UAMI），这是90%同类报错的直接原因。
• 若使用增量模式但未对凭据引用的UAMI资源ID做跨环境参数化，或部署任务使用的服务身份权限不足，会触发凭据与工厂标识绑定关系的校验失败。

• 先核对Azure DevOps中ARM部署任务的部署模式配置，确认是否选中了完整部署模式。
• 检查ADF CI/CD生成的ARMTemplateForFactory.json模板文件，查看Microsoft.DataFactory/factories根资源段是否声明了identity属性下的用户分配托管标识列表，同时核对对应环境参数文件是否传入了目标环境正确的UAMI资源ID。
• 检查Pipeline使用的服务连接权限：确认服务连接对应的服务主体/托管标识，对目标ADF实例有写入权限、对要绑定的UAMI有Managed Identity Operator角色，权限不足时部署流程无法完成标识绑定，也会抛出该错误。
• 检查Dev环境中Key Vault链接服务关联的凭据对象，是否硬编码了环境相关的UAMI资源ID、未做参数化处理。

按落地优先级排序：

• 调整部署模式为增量模式
  将ARM部署任务的Deployment mode从Complete修改为Incremental，增量模式不会删除模板中未声明的现有资源配置，可直接保留Test环境ADF提前绑定好的共用UAMI，改完后重新跑一次Pipeline即可验证。
• 补全模板的UAMI参数化配置
  手动编辑ADF生成的ARM模板，在工厂根资源的identity配置块补充UAMI声明，示例：

  "identity": {
    "type": "SystemAssigned,UserAssigned",
    "userAssignedIdentities": {
      "[parameters('sharedUamiResourceId')]": {}
    }
  }
  

  在参数文件中为Dev、Test环境分别配置UAMI ID参数，因为两个环境共用同一个UAMI，两个环境参数值填相同的资源ID即可。同时将Key Vault链接服务关联凭据中引用的UAMI ID替换为参数引用，避免硬编码。
• 配置部署排除规则
  如果不想修改模板，可提前在Test环境ADF中手动绑定好共用UAMI、配置好Key Vault凭据，然后在ADF发布配置（adf_publish分支下的publishConfig.json）中，将凭据类资源加入部署排除列表，部署时不会覆盖Test环境已配置好的凭据与标识绑定关系，跳过对应校验。
• 补全服务连接权限
  给Pipeline使用的服务连接对应身份，在目标ADF资源上分配Contributor角色，在共用UAMI资源上分配Managed Identity Operator角色，确保部署流程有足够权限完成标识绑定操作。

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