使用BusyBox Ash运行Shell脚本时退出码141故障排查

问题描述 #

有一段在/bin/bash环境下运行完全正常的Shell脚本：

#!/bin/bash
set -exuo pipefail

event="/dev/input/$(cat /proc/bus/input/devices \
    | sed '1,/Name="SZH usb keyboard"/d' \
    | grep Handlers= \
    | head -n1 \
    | tr '=' ' ' \
    | tr ' ' '\n' \
    | grep -E '^event[0-9]+$' \
    | head -n1)"

echo "Enabling scrolllock for $event ..."
"$(dirname "$0")"/ledToggler.py "$event" scrolllock scrolllock 1 1

将脚本开头的/bin/bash替换为/bin/busybox ash后，脚本无法正常运行，返回退出码141，输出如下：

+ cat /proc/bus/input/devices
+ sed '1,/Name="SZH usb keyboard"/d'
+ grep 'Handlers='
+ head -n1
+ tr ' ' '\n'
+ grep -E '^event[0-9]+$'
+ head -n1
+ tr '=' ' '
+ event=/dev/input/event4

原因分析 #

退出码141对应管道进程收到SIGPIPE信号：当管道一端的进程提前退出（比如head -n1读取到目标数据后立即终止），另一端的进程还在向管道写数据时，内核会发送SIGPIPE终止写进程。问题根源在于Ash和Bash对set -e（errexit，命令出错即终止脚本）的处理逻辑差异：

• Bash行为：启用set -e时，仅检查管道中最后一个命令的退出状态，只要最后一个命令执行成功，整个管道视为正常。即使上游进程因SIGPIPE退出，Bash不会触发脚本终止。
• BusyBox Ash行为：set -e会检查管道中所有命令的退出状态。当管道中的sed/grep/tr等进程因SIGPIPE退出（退出码141），Ash会直接触发set -e规则终止脚本，导致后续的echo和Python脚本调用根本没执行。

从输出可见event变量已被正确赋值，说明管道逻辑本身没问题，只是Ash的严格校验提前终止了脚本。

解决办法 #

针对Ash的特性，可通过以下方式修复：

• 临时禁用set -e：在管道代码段前后分别关闭和恢复errexit：

  set +e
  event="/dev/input/$(cat /proc/bus/input/devices \
      | sed '1,/Name="SZH usb keyboard"/d' \
      | grep Handlers= \
      | head -n1 \
      | tr '=' ' ' \
      | tr ' ' '\n' \
      | grep -E '^event[0-9]+$' \
      | head -n1)"
  set -e
  

• 忽略管道命令的退出码：给管道中每个命令添加|| true，强制将非零退出码转为0：

  event="/dev/input/$(cat /proc/bus/input/devices || true \
      | sed '1,/Name="SZH usb keyboard"/d' || true \
      | grep Handlers= || true \
      | head -n1 || true \
      | tr '=' ' ' || true \
      | tr ' ' '\n' || true \
      | grep -E '^event[0-9]+$' || true \
      | head -n1 || true)"
  

• 简化管道逻辑：用awk一次性完成所有文本处理，减少多进程管道带来的SIGPIPE风险：

  event="/dev/input/$(awk '/Name="SZH usb keyboard"/ {flag=1} flag && /Handlers=/ {split($2, h, "="); split(h[2], arr, " "); for(i in arr) if(arr[i] ~ /^event[0-9]+$/) {print arr[i]; exit}}' /proc/bus/input/devices)"
  

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