如何在Bash中强制变量类型？err函数错误处理异常排查

云原生阿岚

2026-6-24

Bash err函数的问题根源及修复

问题出在哪？

1. 参数展开错误无法被`if`捕获

${1:?err called with no arguments}属于Bash的参数展开语法，当没有传入任何参数时，这个语法会直接触发shell的错误输出并终止脚本（如果开启-u选项的话），根本不会走到if ! declare的判断逻辑里，自然无法触发code=70的分支。

2. `declare -i`的返回值逻辑不符合预期

当第一个参数是非数字时，declare -i code=非数字会把code强制赋值为0，并且declare命令本身会返回0（成功状态）——因为它成功创建了整数变量并完成了赋值（非数字被转成0）。这就导致if ! declare ...的条件永远不成立，code=70的分支永远不会执行。

修复后的err函数

function err {
    # 先处理无参数调用的情况
    if [ $# -eq 0 ]; then
        printf "%s: err called with no arguments\n" "${0##*/}" >&2
        exit 70
    fi

    # 验证第一个参数是否为有效整数
    if ! [[ "$1" =~ ^[0-9]+$ ]]; then
        local code=70
        local invalid_code="$1"
        shift
        # 输出包含无效退出码的错误信息
        if [ -t 2 ]; then
            printf "%s: \e[1;31mInvalid exit code '%s': %s\e[0m\n" "${0##*/}" "$invalid_code" "$*" >&2
        else
            printf "%s: Invalid exit code '%s': %s\n" "${0##*/}" "$invalid_code" "$*" >&2
        fi
        exit "$code"
    fi

    # 处理正常调用的情况
    local code="$1"
    shift
    if [ -t 2 ]; then
        printf "%s: \e[1;31m%s\e[0m\n" "${0##*/}" "$*" >&2
    else
        printf "%s: %s\n" "${0##*/}" "$*" >&2
    fi

    exit "$code"
}