Shell脚本函数返回非0值触发异常退出问题排查与修复

问题现象 #

编写的Shell脚本需要根据文件是否存在执行后续操作，但文件不存在时无法进入对应if分支；用-x参数调试发现，函数返回后脚本直接退出，仅文件存在时判断逻辑正常。

原因解析 #

问题核心在于脚本开头的set -e指令：

• set -e的作用是当脚本中任何命令返回非0退出状态时，立即终止脚本执行。
• 当文件不存在时，is_file_found函数返回1（定义的FALSE值），这个非0退出状态触发了set -e的终止规则，导致脚本直接退出，后续的if判断代码根本没机会执行。
• 文件存在时，函数返回0（TRUE），符合set -e的正常执行条件，脚本才会继续走后面的逻辑。

修复方案 #

以下几种可行修复方式，可根据需求选择：

方案1：移除set -e（最简单） #

如果你的脚本不需要严格的“命令出错即退出”约束，直接删掉set -e这一行即可，脚本就能正常处理文件不存在的分支。

方案2：调用函数时屏蔽set -e触发 #

在调用is_file_found时添加|| true，将函数的非0返回“中和”为0，避免触发脚本退出：

is_file_found ${filepath} || true
if [ $? -eq 1 ]; then
    echo "${filepath} not found."
fi

方案3：直接在if条件中调用函数（更优雅） #

把函数调用直接放到if条件里，set -e不会对if语句的条件判断命令触发退出（if本身会处理退出码）：

test() {
    filepath="notexist.txt"
    # filepath="exist.txt"   # 使用此行会触发正常输出
    if ! is_file_found "${filepath}"; then
        echo "${filepath} not found."
        return  # 可选，如需提前退出函数
    fi
    echo "${filepath} found."
}

修复后的完整脚本示例（方案3） #

#!/usr/bin/env bash
set -e
#set -v
#set -x

# 定义常量
readonly TRUE=0
readonly FALSE=1

# 文件存在返回$TRUE(0)，不存在返回$FALSE(1)
is_file_found() {
    [ -f "$1" ] && return $TRUE || return $FALSE
}

test() {
    filepath="notexist.txt"
    # filepath="exist.txt"   # 使用此行会触发正常输出
    if ! is_file_found "${filepath}"; then
        echo "${filepath} not found."
        return
    fi
    echo "${filepath} found."
}

main() {
    case "$1" in
    "test")
        test "$2"
        ;;
    esac
}
main "$@"

验证结果 #

• 文件不存在时，脚本会输出notexist.txt not found.，不会提前退出；
• 文件存在时，输出exist.txt found.，逻辑正常。

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