shell错误处理

四 19 十一月 2026

错误和异常主要的区别在于是否需要脚本的编写者进行处理。 对于错误,通常是脚本本身的问题或者是系统的运行环境不符合预期,这种时候停止脚本的运行是更加妥当的选择。 而异常则是需要脚本处理的问题,如curl请求失败、文件操作无权限等等。

Shell脚本本身并没有明确区分错误和异常,只有返回码(exit code)用于判断程序执行状态。

#!/bin/sh
false
if [[ $? -ne 0 ]]; then
    echo "错误"
fi

每条语句都进行判断不现实。如果程序出现预期之外的错误,脚本并不会停止执行,可能会产生非预期的行为。Shell脚本前通常会加set -o errexit -o pipefail以在错误时及时退出脚本。 执行false语句后脚本会直接退出。

#!/bin/sh
set -o errexit -o pipefail
! false
if [[ ${PIPESTATUS[0]} -ne 0 ]]; then
    echo "错误"
fi

这里的!就是取反,其原理是Shell在执行判断语句(比如if的条件)时不会在错误时退出,即整个语句的返回码是0。不过也是因为这个原因就无法使用$?获得真正的返回码(永远是0),必须要用给管道指令设计的PIPESTATUS。

简单的包装一下,并且读取标准错误流的输出,我们就得到了一个set -e环境下的简易“try-catch”。

#!/bin/sh
set -o errexit -o pipefail
__try() {
    if [[ $try_status -eq 0 ]]; then  # 用于连续try时,出错后不继续进行
        ! exception=$( $@ 2>&1 >/dev/null)
        try_status=${PIPESTATUS[0]}
    fi
}
__catch() {
    _old_try=$try_status
    try_status=0
    [[ $_old_try -ne 0 ]]
}
# Usage
__try expr 1 / 0

 if __catch e; then
        echo "错误: $e"
fi

实现同样效果的还有trap方式和set +e方式。

在进入try块时设置了set -e,而之前设置了set +e。如果遇到错误则会结束set -e部分的语句,而运行catch部分的错误处理代码。

# in case try-catch is nested, we set +e before so the parent handler doesn't catch us instead
alias try='[[ $__oo__insideTryCatch -eq 0 ]] || __oo__presetShellOpts="$(echo $- | sed 's/[is]//g')"; __oo__insideTryCatch+=1; set +e; ( set -e; true; '
alias catch='); declare __oo__tryResult=$?; __oo__insideTryCatch+=-1; [[ $__oo__insideTryCatch -lt 1 ]] || set -${__oo__presetShellOpts:-e} && Exception::Extract $__oo__tryResult || '

上面的方案只能同时获得一个流,要么是标准错误流,要么是标准输出流。

通过一种非常怪异的方法同时得到标准输出流和标准错误流的输出。先来看下最终的__try函数:

#!/bin/sh
__try() {
    [[ $_try_return -eq 0 ]] && eval $({ ! _1=$({ _0=$($@); } 2>&1; echo -n "_try_out='$_0' _try_return=$? " >&2); echo -n "_try_err='$_1'"; } 2>&1)
}
__catch() {
    _old_try=$_try_return
    _try_return=0
    export $1="$_try_err"
    [[ $_old_try -ne 0 ]]
}

排除eval,可以将剩余部分展开如下

{
    ! _1=$(
        { 
            _0=$($@) 
        } 2>&1
        echo -n "_try_out='$_0' _try_return=$? " >&2
    )
    echo -n "_try_err='$_1'"
} 2>&1

最内层_0=$($@)显然就是执行参数函数的地方。它将标准输出(stdout)保存到变量$_0之中,并在外层的2>&1将标准错误(stderr)重定向到stdout。

变量$_0:指令输出的stdout stdout:指令输出的stderr 之后,又执行了语句echo -n "_try_out='$_0' _try_return=$? " >&2,将一段信息打印(重定向)到stderr。注意,由于这是一条中括号内的指令,因此在执行到语句的时候相关变量(比如$?)才会被替换。此时

stdout:指令输出的stderr stderr:"_try_out='指令输出的stdout' _try_return=指令返回码 " 再向外走一层,! _1=$( ... )将stdout保存到了变量$_1。这里的感叹号的用法和老方法中的相同。此时

变量$_1:指令输出的stderr(之前保存在stdout之中) stderr:"_try_out='指令输出的stdout' _try_return=指令返回码 " 之后和之前类似的语句echo -n "_try_err='$_1'"将另一些信息打印到stdout。此时

stdout:"_try_err='指令输出的stderr'" stderr:"_try_out='指令输出的stdout' _try_return=指令返回码 " 最后语句2>&1将stderr重定向到了stdout。注意是重定向,因此先输出的内容仍会在前面。所以最终状态是

stdout:"_try_out='指令输出的stdout' _try_return=指令返回码 _try_err='指令输出的stderr'" stderr:空 所以,一顿骚操作下来我们就得到了一段包含指令输出的“生成指令”!而最后通过eval $( ... )执行,就成功的将指令的stdout、stderr、返回码给带了出来。

不过这个方法也并不是没有缺点。最主要的问题是这个方法给脚本带来了额外的开销,流重定向的影响倒是不大,关键是echo的指令替换和最后的eval。原作者这里使用的是declare -p,性能应该稍好于echo,但是经过测试似乎有兼容性问题(sh之下)。

简单的进行Benchmark与原方法进行测试,可以看到性能确实差了不少。不过一来__try的使用次数通常有限,二来提供完整的stdout和stderr在编码时会方便许多,而且其实对脚本来说一两毫秒的性能损耗也并不算大,因此我还是挺乐意使用这个新的方式的。

$ ./try_benchmark.sh
Old way: 
real    0m0.722s
user    0m0.502s
sys     0m0.290s
New way: 
real    0m2.679s
user    0m2.274s
sys     0m0.867s

Benchmark代码如下

#!/bin/sh
cat > temp.sh <<EOF
#!/bin/sh
set -o errexit -o pipefail
__try() {
    ! exception=\$( \$@ 2>&1 >/dev/null)
    try_status=\${PIPESTATUS[0]}
}
func() {
    echo "$(seq 1 100)"
    echo "$(seq 1 100)" >&2
}
for i in {1..1000}; do
    __try func
done
EOF
echo "Old way: "
time sh temp.sh
cat > temp.sh <<EOF
#!/bin/sh
set -o errexit -o pipefail
__try() {
    eval \$({ ! _1=\$({ _0=\$(\$@); } 2>&1; echo -n "_try_out='\$_0' _try_return=\$? " >&2); echo -n "_try_err='\$_1'"; } 2>&1)
}
func() {
    echo "$(seq 1 100)"
    echo "$(seq 1 100)" >&2
}
for i in {1..1000}; do
    __try func
done
EOF
echo "New way: "
time sh temp.sh
rm -f temp.sh

Category: 编程