PowerShell写入stderr是否会导致Jenkins Pipeline任务失败？

首先明确核心结论：Jenkins 不会因为 PowerShell 执行过程中往 stderr、错误流写了内容就自动判任务失败，它的判定完全和 PowerShell 进程的最终退出码绑定，和大家默认的“stderr非空即失败”的认知有明显差异。

实际判定规则 #

• 步骤的成功/失败结果，完全由 PowerShell 脚本执行完成后返回的进程退出码决定：
  • 退出码为 0：不管执行过程中错误流写了多少内容、打印了多少错误栈，Jenkins 都会标记步骤执行成功
  • 退出码非 0：哪怕全程没输出任何错误提示，Jenkins 也会标记步骤执行失败
• 提供PowerShell Pipeline能力的插件，它的执行Wrapper脚本没有任何对stderr内容的额外校验逻辑，只是原样透传PowerShell进程的最终退出状态。

文档描述不准的原因 #

官方文档提到“PowerShell错误流非空就会触发步骤返回非零退出状态”的表述存在明显偏差，实际触发失败的场景和大家的体感差异，本质是来自PowerShell自身的错误处理机制：

1. PowerShell 默认的 $ErrorActionPreference 值为 Continue
   这种配置下，哪怕执行中触发了Write-Error、外部原生程序往stderr写内容，脚本都只会把对应信息写入错误流，然后继续往下执行，直到脚本跑完正常退出，进程返回0退出码，Jenkins自然判定成功。
2. 只有当配置 $ErrorActionPreference = "Stop" 时，PowerShell碰到任何终止性错误才会直接中断脚本执行，此时进程会返回非0的退出码（通常是1），才会被Jenkins捕捉到判定失败。

不同场景的实际结果对照 #

结合实测的运行输出，可以完全对应所有场景的行为：

• 场景1：不设置$ErrorActionPreference，执行Write-Error 'Something terrible has happened!'
  结果：错误流有内容，脚本正常执行完成，退出码为0 → Jenkins任务成功
• 场景2：设置$ErrorActionPreference = "Stop"，执行Write-Error 'Something terrible has happened!'
  结果：碰到错误直接中断脚本，退出码为1 → Jenkins任务失败，也就是官方文档举的例子对应的实际触发条件
• 场景3：任意$ErrorActionPreference配置下，执行cmd.exe /c "echo hello 1>&2"
  结果：cmd.exe本身退出码为0，PowerShell只是把cmd写入stderr的内容包装成错误对象存入错误流，没有触发脚本中断，最终进程退出码为0 → 哪怕输出了一堆RemoteException的错误栈，Jenkins最终还是判定任务成功，和实测结果完全一致
• 场景4：任意$ErrorActionPreference配置下，执行会返回非0退出码的原生命令（比如cmd.exe /c "exit 1"）
  结果：PowerShell会直接透传原生命令的非0退出码，进程最终退出码非0 → Jenkins任务失败

补充常见误区：很多人以为PowerShell只要错误流不为空就会返回非0退出码，实际上错误流只是一个保存错误信息的集合，本身不会修改进程的退出状态；只有当错误触发了脚本中断、或是被调用的程序主动返回非0退出码时，进程退出状态才会被修改。

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