Azure DevOps向master分支cherry-pick报冲突需本地操作问题

问题核心定位 #

仅Master分支执行cherry-pick报错、其余分支相同操作全正常的情况，90%以上不是真的代码冲突，是Azure DevOps Repos的已知逻辑bug：凡是对受保护分支做直接写入类操作被拦截时，系统会统一抛出Encountered conflicts when cherry-picking commit xxx. This operation needs to be performed locally.的误导性提示，和实际代码冲突没有关系。

分步排查与零本地操作落地方案 #

所有操作均可在Azure DevOps网页端完成，不需要开发本地执行Git命令，符合流程管控要求。

1. 排查隐性权限拦截（最高发原因） #

这类配置不在常规分支策略页面展示，很容易被漏查：

• 进入代码仓库的分支列表，找到Master分支，点击右侧更多操作按钮选择「分支安全性」
• 选中你当前执行操作的账号/所属用户组，确认以下权限为「允许」状态：
  • 参与提交
  • 创建分支
  • 如果Master分支开启了「所有变更必须通过PR合入」策略，可临时给操作账号开放「绕过分支策略」权限，也可以直接用下面的中转分支方案不需要调整权限
• 快速验证方式：在Master分支上通过网页端编辑任意测试文件尝试提交，如果提交失败提示无权限，即可确认是权限拦截导致的误报。

2. 适配按需发布场景的标准化Cherry-pick流程 #

不管是权限拦截还是真的存在文件冲突，都可以用这个流程绕开网页端直接cherry-pick到受保护分支的限制，完全适配你们跨周期挑选UAT提交上线的场景：

• 找到UAT分支上需要迁移的目标提交，触发cherry-pick操作时，不要选择Master作为目标分支，选择新建临时中转分支，分支名可按上线标识命名，比如release/uat-pick-42af19
• 新建分支默认开放直接提交权限，这一步cherry-pick操作不会触发拦截，可正常执行完成
• 存在多个待上线提交时，逐个在网页端将目标提交cherry-pick到这个临时中转分支即可
• 临时分支内容准备完成后，直接在网页端发起临时分支到Master分支的PR，走你们现有的PR审批、CI校验流程即可
• 如果PR提示存在代码冲突，直接点击PR页面内置的「冲突解决」按钮，在网页端可视化编辑器里完成冲突处理，全程不需要本地操作
• PR合并完成后删除临时中转分支即可，所有操作全程留痕可审计，符合流程规范要求。

避坑提示 #

Azure DevOps网页端的直接cherry-pick功能对受保护分支的兼容性很差，只要目标分支配置了任何直接提交限制，不管有没有代码冲突都会抛出需要本地操作的报错，不建议直接对生产类受保护分支使用该功能。上述中转分支提PR的方案不需要调整现有分支策略、CI/CD配置，可直接落地解决按需发布的流程卡点。

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