使用Azure DevOps SDK触发YAML管道时的异常阶段跳过行为

管道阶段依赖定义 #

Stage: A

Stage: B

Stage: C
DependsOn:
- A 
- B

Stage: D

Stage: E

Stage: F
DependsOn:
 - D
 - E

问题现象 #

使用Microsoft.Azure.Pipelines.WebApi的.NET代码触发管道时，指定StagesToSkip为"StageA, Stage D"，出现以下行为：

• StageC被自动跳过
• StageF正常完成

但通过Azure DevOps UI触发同一管道并跳过相同阶段时，StageC和StageF均能正常运行。

原因分析 #

1. 阶段名称匹配错误 #

UI触发时会自动关联阶段的实际标识符（即YAML中Stage:字段的值，如A、D），即使输入友好名称（如Stage A），UI也会自动映射到正确的标识符。但API触发时需要严格传入YAML中定义的阶段标识符，若传入StageA、Stage D这类非实际标识符的名称，API无法匹配到目标阶段，导致实际跳过的阶段与预期不符。

2. API参数格式与解析逻辑差异 #

• RunPipelineParameters的StagesToSkip属性是IEnumerable<string>类型，若错误地将逗号分隔的单字符串（如"StageA, Stage D"）传入，而非包含两个元素的字符串数组（如["A", "D"]），API会将整个字符串视为单个阶段名称，无法匹配任何阶段，进而触发意外的依赖处理逻辑。
• 旧版本的Microsoft.Azure.Pipelines.WebApi包中，跳过阶段的依赖处理逻辑与UI不一致：API会将跳过的阶段视为"未完成"，导致依赖它的下游阶段因满足"所有依赖未完成"而被跳过；而UI会将跳过的阶段视为"成功完成"，只要有一个依赖阶段正常运行，下游阶段就会继续执行。

3. 依赖阶段的执行状态判定差异 #

Azure DevOps中，被跳过的阶段默认应被视为"成功完成"，但旧版API可能存在判定逻辑bug，导致依赖该阶段的下游阶段被错误跳过。

解决方案 #

1. 传入正确的阶段标识符：确保StagesToSkip传入的是YAML中Stage:字段定义的准确值（如["A", "D"]，而非["StageA", "Stage D"]）。
2. 正确设置参数格式：将StagesToSkip设置为字符串数组，而非逗号分隔的单字符串，示例代码：

runParam.StagesToSkip = new List<string> { "A", "D" };

3. 更新API包版本：将Microsoft.Azure.Pipelines.WebApi NuGet包升级到最新稳定版，确保API行为与Azure DevOps UI一致。
4. 验证阶段依赖逻辑：检查YAML中阶段的condition设置，确保没有自定义条件导致跳过阶段的下游行为异常。

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