ADF管道发布失败：存在无效引用/依赖，合并分支后报错求解决

1. 排查分支资源的引用一致性 #

• 直接查看dev分支下Linked Services、Datasets、Pipelines的JSON定义文件，确认是否存在指向已删除/不存在资源的引用：
  • 检查管道JSON里的datasets/linkedServices节点，对应资源是否在dev分支的对应目录下存在
  • 重点核对之前合并又撤销的3个管道，对比撤销前后的JSON差异，清理残留的master分支无效引用

2. 清理ADF门户缓存 #

• 关闭所有打开ADF门户的浏览器窗口，清除浏览器缓存（优先清除ADF相关站点缓存）
• 重新打开ADF门户，切换到dev分支后点击右上角的刷新按钮，确保加载最新分支资源

3. 重新配置Git分支映射 #

• 进入ADF的Git配置页面，确认协作分支为dev、发布分支为你的目标分支（如master）
• 取消勾选Import existing resources选项，重新连接Git仓库
• 连接完成后，手动对比dev分支与发布分支的所有资源，确保无缺失或冗余资源

4. 手动修复无效引用并验证 #

• 定位到具体无效引用的资源（如管道里的无效数据集），删除无效项后重新选择正确资源
• 保存变更后，点击ADF左侧菜单的「验证」按钮，选择所有资源进行全量验证
• 验证通过后再执行发布操作

5. 紧急临时替代方案 #

• 若上述步骤无效，可临时创建新协作分支（如dev-temp），将dev分支中正常的资源手动复制到新分支
• 配置ADF使用该新分支作为协作分支，测试发布流程是否正常
• 确认正常后，将新分支合并到发布分支，后续使用新分支开发

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