调用##vso[task.complete result=Failed;]未使脚本步骤失败是否为Azure Pipelines问题

• 你的原有认知存在偏差：##vso[task.complete result=Failed;]本身不具备立即终止当前正在运行的脚本的能力，它只是向Azure Pipelines代理发送了一个「将当前步骤的最终执行结果标记为失败」的信号。脚本会继续执行后续所有代码，直到脚本本身退出后，代理才会应用你设置的步骤状态。

针对Linux容器代理环境的常见失效原因 #

• 输出缓冲问题：Linux环境下非交互式shell默认会对标准输出做缓冲处理，你打印的vso命令可能暂存在内存缓冲区中，没有实时被代理的日志监听程序捕获，直到脚本执行完毕才会统一输出，导致命令未生效。可以在打印vso命令后手动刷新输出缓冲，或者在脚本开头开启无缓冲配置。
• 未主动终止脚本：很多场景下用户打印vso命令后未主动退出脚本，后续如果有其他修改步骤状态的逻辑、或者脚本最终返回了0的退出码，部分旧版本代理会出现状态覆盖的问题。正确用法是打印vso命令后立即调用exit 1终止脚本执行。
• 容器日志缓冲：容器化代理的日志默认通过容器stdout收集，部分日志驱动会自带一层输出缓冲，导致vso命令延迟送达代理。可以在exit 1前添加极短的等待时间，比如sleep 0.1确保命令被成功接收。

是否为Azure Pipelines Bug #

只有2.190.0版本之前的Linux代理存在已知的vso命令解析Bug，如果你使用的是低于该版本的代理，可以升级到最新稳定版验证。绝大多数场景下的失效都是使用姿势不符合要求导致的，并非平台Bug。 #

正确使用示例 #

# 业务逻辑执行后判断返回码
if [ $? -ne 0 ]; then
  echo "##vso[task.complete result=Failed;]自定义错误信息"
  # 立即终止脚本
  exit 1
fi

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