如何快速定位开启set -o pipefail后bash/zsh管道的首个失败环节？

开启set -o pipefail后，包含多个管道|的bash/zsh命令执行失败，比如示例命令：

set -o pipefail; echo "123456" | head -c2 | grep 5 | cat

虽然可以检查整体退出码，但无法定位管道中哪个环节最先失败。有没有比逐个拆分管道排查更简便的方法？

实际触发问题的命令为：

zstdcat metadata.tsv.zst | \
tsv-summarize -H --group-by Nextclade_pango --count | \
tsv-filter -H --ge 'count:2' | \
tsv-select -H -f1 >open_lineages.txt

1. 利用shell内置的管道状态数组 #

bash和zsh都内置了专门的变量，能直接获取管道中每个命令的退出码：

• bash环境：使用大写的PIPESTATUS数组，执行完目标命令后直接打印即可：

  set -o pipefail
  zstdcat metadata.tsv.zst | \
  tsv-summarize -H --group-by Nextclade_pango --count | \
  tsv-filter -H --ge 'count:2' | \
  tsv-select -H -f1 >open_lineages.txt
  echo "各命令退出码: ${PIPESTATUS[@]}"
  

  输出的数字顺序和管道中命令的顺序完全对应，第一个非0的数字对应的就是首个失败的环节。

• zsh环境：使用小写的pipestatus数组，用法和bash一致：

  set -o pipefail
  zstdcat metadata.tsv.zst | \
  tsv-summarize -H --group-by Nextclade_pango --count | \
  tsv-filter -H --ge 'count:2' | \
  tsv-select -H -f1 >open_lineages.txt
  echo "各命令退出码: ${pipestatus[@]}"
  

2. 直观展示命令与退出码的对应关系 #

如果想直接看到每个命令和它的退出码，可以用简单脚本批量处理：

# bash版本
set -o pipefail
# 按管道顺序列出所有命令
pipe_cmds=(
  "zstdcat metadata.tsv.zst"
  "tsv-summarize -H --group-by Nextclade_pango --count"
  "tsv-filter -H --ge 'count:2'"
  "tsv-select -H -f1 >open_lineages.txt"
)
# 执行完整管道命令
eval "${pipe_cmds[0]} | ${pipe_cmds[1]} | ${pipe_cmds[2]} | ${pipe_cmds[3]}"
# 遍历输出每一步的执行状态
for idx in "${!pipe_cmds[@]}"; do
  cmd_num=$((idx + 1))
  echo "第${cmd_num}步命令: ${pipe_cmds[idx]}"
  echo "退出码: ${PIPESTATUS[idx]}"
  echo "---"
done

运行后能清晰看到每一步的结果，直接定位首个退出码非0的环节。

3. 针对性排查问题根源 #

找到失败的命令后，单独运行该命令（带上前序管道的输入）就能快速定位原因：
比如如果是第二步的tsv-summarize失败，可以先运行：

zstdcat metadata.tsv.zst | tsv-summarize -H --group-by Nextclade_pango --count

通过工具的错误输出，检查输入文件格式、参数是否符合要求即可。

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