WhereScape RED执行PowerShell脚本后Job中止失败解决方法

核心判定逻辑说明 #

WhereScape RED 对外部脚本类任务的成功/失败判定，不依赖脚本实际业务执行结果，默认以调用进程的退出码为核心依据，同时部分配置下会检测标准错误流（stderr）是否有输出。PowerShell 宿主进程本身存在默认退出码覆盖、隐式返回非0值的特性，哪怕脚本业务逻辑全量执行无报错，也可能返回非0退出码触发RED的失败判定，直接中止后续作业。

可落地调整步骤 #

• 脚本层强制显式指定退出码
  在PowerShell脚本的正常执行流程末尾，显式添加exit 0语句，不要依赖PowerShell的默认返回值。如果脚本内加了try/catch异常捕获逻辑，捕获到业务异常时对应返回非0退出码即可，确保正常跑完的场景下脚本一定会返回0值。
• 调整RED中PowerShell任务的调用命令
  不要直接把ps1脚本路径填到执行命令框，替换为带参数的显式调用命令，透传脚本真实退出码，参考命令如下：

  powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "C:\你的脚本实际存放绝对路径.ps1"; exit $LASTEXITCODE
  

  参数说明：
  • -NoProfile：跳过加载用户侧的PowerShell配置文件，避免配置文件里的自定义逻辑产生异常返回
  • -NonInteractive：禁止脚本弹出交互提示，避免进程卡住无返回
  • 末尾exit $LASTEXITCODE：将脚本本身的真实退出码直接透传给RED的调用进程，避免被PowerShell宿主进程的默认返回值覆盖
• 关闭任务的stderr误判开关
  找到该PowerShell任务的高级配置页，取消勾选*「检测到标准错误流输出即判定任务失败」*的选项。PowerShell默认会把警告、详细日志类信息写入stderr流，并非只有报错才会写stderr，开着这个开关非常容易产生误判，调整后仅以进程退出码作为判定依据即可。
• 回归验证
  配置修改完成后单独运行该任务，查看RED任务日志中记录的进程退出码，若仍为非0值，可临时将脚本内所有命令的输出重定向到本地日志文件，排查是哪条命令隐式返回了非0结果，针对性处理即可。

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